Kapsamlar
Dört kapsam, her istekte anlık olarak çözümlenir. Hangi uç noktanın hangi kapsamı gerektirdiği ve okundu işaretlemenin neden bir gönderim sayıldığı.
Kapsamlar kimlik bilgisi başınadır: her API key için veya her OAuth2 yetkisi için ayrı tanımlanır. Dört kapsam vardır.
| Kapsam | İzin verdiği işlemler |
|---|---|
whatsapp.read | GET /connections, GET /connections/{id}, GET /account, GET /messages |
whatsapp.send | POST /messages, POST /messages/read |
whatsapp.events | GET /webhook, PUT /webhook, POST /webhook/rotate ve webhook bildirimlerinin alınması |
whatsapp.manage | POST /connections, POST /connections/{id}/pairing-code, POST /connections/{id}/restart, POST /connections/{id}/logout, DELETE /connections/{id} |
Okundu işaretlemek bir gönderimdir, okuma değil
POST /messages/read için whatsapp.send gerekir. Bir okuma işlemi gibi görünür, ancak numaranızdan müşterinin cihazına bir okundu bilgisi iletir; yani giden bir işlemdir. Bunun avantajı şudur: mesaj gönderebilen her istemci okundu da işaretleyebilir. Yeni bir kapsam gerekmez, yeniden onay istenmez.
Çözümleme anlıktır
Kapsamlar ve erişilebilir bağlantı listesi her istekte çözümlenir. Token içinde hiçbir şey önbelleğe alınmaz ve yenilenmesi gereken bir şey yoktur. Bunun iki sonucu vardır:
- Bir anahtarı iptal etmek veya kapsamlarını daraltmak, bir sonraki çağrıdan itibaren geçerli olur.
- Az önce oluşturduğunuz bir bağlantı bir sonraki çağrıda görünür. Yayılma gecikmesi yoktur ve yeniden düzenlenecek bir şey yoktur.
Yetersiz kapsam
Bir uç noktanın gerektirdiği kapsama sahip olmayan bir kimlik bilgisi 403 insufficient_scope yanıtı alır. Durum koduna değil, hata koduna göre dallanın. 403, IP izin listesi reddinde de (ip_not_allowed) döner ve ikisinin çözümü birbirine zıttır: biri anahtarın kapsamlarını düzenlemeniz, diğeri bir adres eklemeniz gerektiği anlamına gelir. Bkz. Hatalar ve idempotency.
Daha azını isteyin
Vermediğiniz kapsam, anahtar sızdığında kötüye kullanılamayacak olandır. Salt okunur bir raporlama işi yalnızca whatsapp.read ister. Bildirim gönderen bir uygulama whatsapp.send ister. Bağlantıları silebilen whatsapp.manage kapsamına ise yalnızca bir kurulum (provisioning) akışının ihtiyacı vardır.