API Studio Zipcat

Antrian = jumlah build yang boleh berjalan bersamaan per akun. Kalau penuh, request baru ditolak 429 queue_full sampai ada build selesai. Pembelian paket lewat Mini App (konfirmasi admin).

Kirim API key di setiap request:

Authorization: Bearer zck_xxxxxxxxxxxxxxxx

Alternatif: header X-API-Key. Key hanya tampil sekali saat dibuat — simpan baik-baik. CORS aktif (*) sehingga bisa dipanggil dari web; jangan taruh key di kode frontend publik, panggil dari server/bot-mu.

POST/api/v1/builds

Mulai build. Dua cara kirim project:

A. Upload ZIP langsung (Content-Type: application/zip, body = isi file) — query: mode=release|debug, callback_url (opsional).

B. Dari URL (Content-Type: application/json): {"zip_url":"https://…/project.zip","mode":"release","callback_url":"https://…"}

Respons 202: {"id":"…","status":"queued","queue":{"used":1,"limit":10}}. ZIP harus berisi pubspec.yaml (project Flutter).

GET/api/v1/builds/{id} — status: queued → uploading → building → success | failed. Saat sukses ada download_url; saat gagal ada error (log langkah yang gagal).

GET/api/v1/builds/{id}/download — unduh APK (disimpan 24 jam).

GET/api/v1/builds — 20 build terakhir.   GET/api/v1/me — paket, sisa antrian, masa aktif.   GET/api/v1/tiers — daftar paket (tanpa key).

Isi callback_url (https, alamat publik) dan kami akan POST JSON status build (sama seperti GET /builds/{id}) saat build selesai atau gagal — tanpa polling. Redirect tidak diikuti.