Cakupan kunci
Pembatasan proyek
Kolom Proyek (Project) membatasi kunci API pada proyek tertentu:
- Apa saja (Any)—kunci memiliki akses ke semua proyek di akun
- Proyek tertentu—kunci hanya bekerja dengan data proyek yang dipilih
Pembatasan ini berperilaku berbeda tergantung metodenya. Pada metode daftar, ia menjadi filter: respons berhasil tetapi hanya berisi data proyek itu. Pada metode yang menunjuk tagihan atau dompet tertentu, permintaan atas objek proyek lain ditolak dengan Restricted project.
| Metode | Kunci yang dibatasi pada proyek |
|---|---|
billing/balances | Data tingkat akun; pembatasan tidak berlaku |
billing/history | Operasi proyek itu plus operasi tingkat akun—pengisian saldo dan bonus |
billing/tariffs | Tarif dan perputaran hanya untuk proyek kunci itu |
invoices/list | Hasil hanya untuk proyek kunci itu |
payments/list | Hasil hanya untuk proyek kunci itu |
statistics/invoices | Dihitung hanya untuk proyek kunci itu |
statistics/payments | Dihitung hanya atas tagihan proyek kunci itu |
invoices/create | projectId dalam permintaan harus sama dengan proyek kunci itu |
invoices/cancel | Tagihan proyek lain tidak dapat diakses |
invoices/bindPayment | Tagihan proyek lain tidak dapat diakses |
Pembatasan cakupan
Cakupan menentukan metode API mana yang dapat dipakai kunci. Ini kolom wajib dengan pilihan ganda.
Panggilan ke metode di luar cakupan kunci ditolak dengan Restricted scope.
Menggabungkan pembatasan
Pembatasan proyek dan cakupan bekerja bersama. Misalnya, jika kunci dibatasi pada metode tagihan dan terikat pada proyek tertentu, maka:
- Hanya metode tagihan yang tersedia
- Data difilter hanya untuk proyek yang ditentukan
- Permintaan pembayaran atau statistik ditolak
- Permintaan data proyek lain ditolak