Dokumentasi Genesis API
Semua yang Anda butuhkan untuk integrasi: autentikasi, limit, endpoint, dan skema respons.
Paket & limit
Limit ditentukan oleh paket Anda. Status terkini selalu tersedia di /account/usage dan di header setiap respons.
| Trial | Start | Pro | Max | |
|---|---|---|---|---|
| Panggilan per bulan | 500K | 2 jt | 5 jt | 10 jt |
| Request per detik | 1 | 2 | 5 | 15 |
| Kesegaran data | 60 dtk | 30 dtk | 10 dtk | 5 dtk |
Endpoint di luar paket Anda mengembalikan 403 dengan kode plan_restricted. Request di atas limit tidak pernah ditagih.
Hanya respons 200 yang dihitung sebagai panggilan. Respons 304 (tidak berubah) dan error 4xx/5xx tidak memakai kuota Anda, tetapi tetap dihitung dalam limit request per detik.
Volume unduhan dibatasi 60 MB data terkompresi per 10 detik per key. Polling semua kumpulan data sesuai kesegaran paket Anda masih sangat cukup; respons di bawah 64 KB tidak dihitung. Jika melebihi batas — 429 download_limited hingga jendela berakhir, tidak dihitung. Hemat traffic dengan If-None-Match, filter, dan parameter coin.
Header rate limit
| Header | Deskripsi | |
|---|---|---|
X-RateLimit-Limit | Limit request per detik untuk paket Anda | |
X-RateLimit-Remaining | Sisa request di jendela saat ini | |
X-RateLimit-Reset | Waktu Unix saat jendela direset | |
X-Quota-Limit | Kuota panggilan untuk periode 30 hari saat ini | |
X-Quota-Remaining | Sisa panggilan dalam periode | |
X-Quota-Reset | Waktu Unix saat kuota direset | |
Retry-After | Detik yang perlu ditunggu sebelum mencoba lagi (pada 429 dan 503) |