Webhook, API Developer, dan Paket
API developer
Selain webhook, Etalasse menyediakan API merchant yang bisa diakses dengan personal access token (PAT). Token berawalan eta_pat_ dan bertindak sebagai Pemilik, jadi simpan seperti password dan jangan taruh di kode klien atau repositori.
Deskripsi lengkap API yang bisa diakses PAT ada di berkas OpenAPI: etalasse-api/docs/openapi.yaml. Rute webhook (membuat endpoint, melihat log, kirim ulang, dan lainnya) juga bisa dipakai lewat PAT, sehingga pengelolaan endpoint bisa diotomatisasi.
Paket dan batas
| Paket | Webhook | Maksimal endpoint |
|---|---|---|
| Free | Tidak | - |
| Growth | Tidak | - |
| Pro | Ya | 3 |
| Enterprise | Ya | 10 |
Batas keras 10 endpoint per toko berlaku di semua kondisi.
Jika paket turun
Endpoint yang sudah ada tidak dihapus, tetapi berhenti menerima event baru (event bahkan tidak dicatat untuk endpoint itu). Yang tetap bisa dilakukan: melihat daftar dan detail endpoint, menghapus endpoint, melihat log pengiriman. Yang butuh paket: membuat dan mengubah endpoint (termasuk mengaktifkan kembali), rotasi secret, kirim tes, kirim ulang, dan replay.
Kode galat
Respons galat berbentuk { "status": false, "code": "...", "message": "...", "field": "..." } (field hanya jika relevan).
| HTTP | Kode | Kapan |
|---|---|---|
| 402 | PLAN_LIMIT | Paket tidak mencakup webhook, atau batas endpoint paket habis |
| 403 | (peran) | Akun Kasir |
| 404 | NOT_FOUND | Endpoint, pengiriman, atau event tidak ada atau milik toko lain |
| 409 | ENDPOINT_LIMIT | Sudah 10 endpoint (batas keras) |
| 409 | DUPLICATE_URL | URL itu sudah terdaftar di toko Anda |
| 409 | ENDPOINT_INACTIVE | Kirim ulang atau replay ke endpoint nonaktif |
| 422 | VALIDATION_ERROR | Isian salah (field: url, events, description, overlap_hours) |
| 422 | URL_SCHEME, URL_INVALID, URL_CREDENTIALS, URL_HOST_BLOCKED, URL_PORT_BLOCKED, ADDRESS_BLOCKED, DNS_FAILED | URL ditolak, lihat aturan URL |
| 429 | RATE_LIMITED | Terlalu banyak kirim tes (maksimal 10 per menit) |
FAQ
Kenapa saya tidak bisa menambah endpoint?
Periksa paket Anda (Pro atau Enterprise), jumlah endpoint terhadap batas paket, dan peran akun (Pemilik atau Admin).
Saya kehilangan secret. Bagaimana?
Rotasi secret. Secret lama tidak bisa ditampilkan lagi.
Endpoint saya tiba-tiba nonaktif.
Kemungkinan nonaktif otomatis karena kegagalan beruntun. Perbaiki server, aktifkan lagi, lalu replay event yang terlewat.
Event saya tiba dua kali.
Wajar pada pengiriman at-least-once. Abaikan event dengan id yang sudah diproses.
Event tiba tidak berurutan.
Urutan tidak dijamin. Pakai cap waktu pada data.
Apakah data modal atau password dikirim?
Tidak. Lihat yang tidak pernah dikirim.
Berapa lama log disimpan?
30 hari.