Anahtar kapsamı
Proje kısıtlaması
Proje (Project) alanı, API anahtarını belirli bir projeyle sınırlar:
- Herhangi biri (Any) — anahtar, hesaptaki tüm projelere erişebilir
- Belirli bir proje — anahtar, yalnızca seçilen projenin verileriyle çalışır
Kısıtlama, metoda göre farklı davranır. Listeleme metotlarında bir filtredir: yanıt başarılıdır ama yalnızca projenin verilerini içerir. Belirli bir faturaya veya cüzdana yönelen metotlarda, başka bir projenin nesnesi için yapılan istek Restricted project ile reddedilir.
| Metot | Projeyle sınırlanmış anahtar |
|---|---|
billing/balances | Hesap düzeyinde veriler; kısıtlama uygulanmaz |
billing/history | Projenin işlemleri artı hesap düzeyindeki işlemler — bakiye yüklemeleri ve bonuslar |
billing/tariffs | Yalnızca anahtarın projesi için ücret oranı ve ciro |
invoices/list | Yalnızca anahtarın projesi için sonuçlar |
payments/list | Yalnızca anahtarın projesi için sonuçlar |
statistics/invoices | Yalnızca anahtarın projesi için hesaplanır |
statistics/payments | Yalnızca anahtarın projesinin faturaları üzerinden hesaplanır |
invoices/create | İstekteki projectId, anahtarın projesiyle eşleşmelidir |
invoices/cancel | Başka bir projenin faturasına erişilemez |
invoices/bindPayment | Başka bir projenin faturasına erişilemez |
Kapsam kısıtlaması
Kapsam, anahtarın hangi API metotlarını kullanabileceğini tanımlar. Zorunlu, çoklu seçimli bir alandır.
Anahtarın kapsamı dışındaki bir metodun çağrısı Restricted scope ile reddedilir.
Kısıtlamaları birleştirme
Proje ve kapsam kısıtlamaları birlikte çalışır. Örneğin bir anahtar, fatura metotlarıyla sınırlanmış ve belirli bir projeye bağlanmışsa:
- Yalnızca fatura metotları kullanılabilir
- Veriler yalnızca belirtilen projeye göre filtrelenir
- Ödeme veya istatistik istekleri reddedilir
- Başka projelerin verileri için istekler reddedilir