Authentication

API /v1 memakai token organisasi: string berawalan nyaur_oat_. Satu token milik satu organisasi dan membawa scope organisasi itu di setiap panggilan.

Membuat token

Buat token di dashboard, Pengaturan, API Tokens, atau lewat API (memakai token yang sudah ada):

curl -X POST https://api.nyaur.id/v1/tokens \
  -H "Authorization: Bearer $NYAUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "backend produksi", "mode": "live" }'

mode bernilai sandbox (default) atau live. Secret lengkap dikembalikan sekali di respons create. Nyaur hanya menyimpan hash SHA-256 dan prefix tampilan, jadi token yang hilang harus diganti.

Daftar token: GET /v1/tokens. Cabut token: POST /v1/tokens/{id}/revoke.

Memakai token

Kirim sebagai Bearer credential:

curl https://api.nyaur.id/v1/products \
  -H "Authorization: Bearer $NYAUR_TOKEN"

Simpan token di server. Token di bundle browser atau aplikasi mobile dianggap bocor.

Mode token

Setiap token punya mode sandbox atau live. Mode dipilih saat token dibuat, bukan per request. Lihat Sandbox vs live.

Batas laju

300 permintaan per menit per organisasi. Respons memuat X-RateLimit-Limit dan X-RateLimit-Remaining. Melewati batas mengembalikan 429 dengan Retry-After (detik). Tunggu lalu ulangi.

Format error

{ "error": { "type": "invalid_request", "message": "Query limit/offset tidak valid" } }

Nilai type yang umum: unauthorized, invalid_request, not_found, org_not_active, org_not_reviewed, rate_limited.