Anahtarlar ve web kancaları
Bu çalışma alanının verdiği kimlik bilgileri ve uç noktalar.
Anahtar ve web kancası araçları
| Araç | Ne yapar |
|---|---|
| listApiKeys | Bu çalışma alanının verdiği her API anahtarı, ne yapabileceği ve hangi adreslerle gönderebileceği; iki anahtarı birbirinden ayırmaya yetecek kadarını gösteren, fazlasını göstermeyen maskelenmiş bir biçimde. |
| rotateApiKey | Bir anahtara yeni bir gizli değer verin; id'si, adı, kapsamları, rolü ve gönderim kapsamı korunur. Örtüşme penceresi yoktur ve yeni gizli değer bir kez gösterilir. |
| setApiKeyEnabled | Bir anahtarı kapatın ya da yeniden açın. Geri alınabilir olan budur: anahtar gizli değerini, kapsamlarını, rolünü ve gönderim kapsamını korur. |
| revokeApiKey | Bir anahtarı kalıcı olarak iptal edin. İptal edilmiş bir anahtar bir daha asla açılamaz, döndürülemez veya değiştirilemez. |
| setApiKeySendScope | Bir anahtarın hangi adreslerle gönderebileceğini iki bağımsız liste olarak belirtin. Verdiğiniz şey, anahtarda olanın YERİNE GEÇER. |
| listWebhooks | Bu çalışma alanının sahip olduğu her web kancası uç noktası, nereye gönderdiği, etkin olup olmadığı ve hangi olayları istediği. İmzalama gizli değerleri asla gösterilmez. |
| listWebhookEvents | Bir uç noktanın abone olabileceği her olay, ailesine göre gruplanmış ve her birinin ne zaman tetiklendiğini söyleyen bir satırla. |
Bir gizli değer, anahtar oluşturulduğunda ya da döndürüldüğünde bir kez gösterilir ve sonrasında hiçbir şey onu geri getirmez. rotateApiKey burada bir gizli değer döndüren tek araçtır; dolayısıyla eski gizli değeri tutan her neyse, bir sonraki çalışmasından önce yenisinin ona verilmesi gerekir.
revokeApiKey'den önce setApiKeyEnabled'a uzanın. Bir anahtarı kapatmak geri alınabilir ve hâlâ ona bağlı bir şey olup olmadığını size söyler; iptal etmek kalıcıdır ve oradan ileriye giden tek yol yeni bir anahtar ve yeni bir gizli değerdir.
Burada createApiKey ve createWebhook yok; createRole'ün olmamasıyla aynı nedenle: bir sohbet penceresinin içinden kimlik bilgisi vermek, sonradan kimsenin görmediği sessiz ve geniş bir değişikliktir. İkisi de Settings içinde, bunu yapan kişinin neyi dağıttığını görebileceği yerde.