Dokumentasi API – iSaaw APIs | Alight Motion Premium

Base URL

https://skyp.isaaw.web.id

Semua endpoint menggunakan base URL di atas.

Format API Key

⚠️ Penting: API Key mendukung 2 format:

Auto-generated: ISAAW-XXXXXXXX (8 karakter acak)
Custom: ISAAW-XXXX (4-20 karakter, huruf/angka)

Contoh custom key: ISAAW-GANTENG, ISAAW-PREMIUM123

Autentikasi

Metode utama: Header X-API-Key.

Header: X-API-Key: ISAAW-XXXXXXXX (direkomendasikan)
Query Param (legacy): ?apikey=ISAAW-XXXXXXXX – masih didukung untuk kompatibilitas, tetapi tidak disarankan.

Catatan Keamanan: Jangan menyimpan API Key di sisi klien (frontend). Gunakan header di server-side.

Paket API Key

Paket	Durasi	Kuota Harian
7 Hari	7 hari	50 request/hari
30 Hari	30 hari	1.100 request/hari

Kuota dihitung per API key dan direset setiap hari berdasarkan zona waktu Asia/Jakarta. Request yang berhasil melewati validasi akan mengurangi kuota secara atomik

Rate Limiting

Sistem menerapkan beberapa lapis proteksi terhadap abuse:

Burst per-key: maksimal 15 request per 10 detik per key.
IP-based: 50 request per menit per IP (kecuali /health dan /config).
Global: 90 request per menit secara keseluruhan (kecuali endpoint publik).
Endpoint publik: 10 request per menit per IP untuk /health dan /config.

Jika batas terlampaui, API mengembalikan status 429 Too Many Requests.

Cek Status API Key

GET /api/key/status

Parameter	Wajib	Keterangan
apikey (header `X-API-Key`)	Ya	API Key (support custom key 4-20 chars)

Contoh Response

{
  "creator": "iSaaw",
  "status": true,
  "active": true,
  "keyStatus": "active",
  "package": "30d",
  "dailyLimit": 1100,
  "dailyUsage": 5,
  "expiresAt": "2026-08-09T23:48:27.247Z",
  "createdAt": "2026-07-10T23:48:27.247Z",
  "usageCount": 42,
  "lastUsedAt": "2026-08-09T12:00:00.000Z",
  "isCustom": false
}

Kirim Link Verifikasi

GET /api/am/sendlink

Parameter	Wajib	Keterangan
email	Ya	Email tujuan verifikasi
apikey (header `X-API-Key`)	Ya	API Key (support custom key 4-20 chars)

Contoh Response

{
  "creator": "iSaaw",
  "status": true,
  "message": "Verification link successfully sent to your email"
}

Verifikasi Premium

GET /api/amp/reqprem

Parameter	Wajib	Keterangan
email	Ya	Email yang digunakan
link	Ya	Link verifikasi dari email
apikey (header `X-API-Key`)	Ya	API Key (support custom key 4-20 chars)

Contoh Response Sukses

{
  "creator": "iSaaw",
  "status": true,
  "message": "Verification successful! Your account is now Premium.",
  "data": {
    "email": "user@example.com",
    "activatedAt": "2026-08-09T20:00:00.000Z",
    "premiumExpiresAt": "2027-08-09T20:00:00.000Z",
    "plan": "premium",
    "premiumActivated": true
  }
}

Kode Error

Status	Arti
400	Parameter tidak valid (email, link, format API key)
401	API Key tidak disertakan atau format salah
403	API Key tidak ditemukan, dicabut, atau kadaluarsa
404	Endpoint tidak ditemukan atau data tidak ada
429	Terlalu banyak request (kuota harian habis atau burst limit)
500	Kesalahan internal server
503	Layanan sementara tidak tersedia

Semua respons error memiliki format { creator: "iSaaw", status: false, error: "..." }.

Contoh Integrasi

Gunakan header X-API-Key untuk autentikasi.

cURL

curl -H "X-API-Key: ISAAW-EXAMPLE123" \
  "https://skyp.isaaw.web.id/api/key/status"

JavaScript (fetch)

fetch('https://skyp.isaaw.web.id/api/am/sendlink?email=user@example.com', {
  headers: {
    'X-API-Key': 'ISAAW-EXAMPLE123'
  }
})
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));

Catatan Keamanan

Jangan bagikan API Key – perlakukan seperti password.
Jangan menyimpan API Key di kode frontend atau repository publik.
Gunakan header X-API-Key sebagai metode utama; query param hanya untuk kompatibilitas.
API Key yang disalahgunakan akan dinonaktifkan tanpa pemberitahuan.