API, Playground ve webhooklarla başlama
API anahtarınızı bulun, güvenli bir ilk istek gönderin ve kimlik bilgilerini açığa çıkarmadan olay bildirimlerini bağlayın.
Güncel API başvurusunu kullanın
Oturum açtıktan sonra API belgelerini açın. Başvuruda desteklenen uç noktalar, gerekli alanlar ve örnekler bulunur. İstek ayrıntıları için onu esas alın; bu kılavuz uç nokta tanımını yinelemek yerine işleyişi açıklar.
Anahtarınızı hazırlayın
Anahtarı görmek veya kopyalamak için kimlik doğrulama adımını izleyin. Belgeler anahtarı görüntülemek ve Playground kullanmak için beş dakikalık doğrulanmış süre tanır; anahtar oluşturmak veya yenilemek yeniden doğrulama gerektirir. Anahtarı parola gibi koruyun: uygulama sunucusunda tutun; açık depolara, tarayıcı koduna veya ekran görüntülerine koymayın.
Güvenli bir ilk istek gönderin
- Playground’u açıp hesabınıza uygun salt okunur bir hazır istek seçin; örneğin SIP kimliklerini listeleme.
- Yöntemi, yolu ve parametreleri inceleyin. Örnek değerler yerine kendi hesabınız için dönen kimlikleri kullanın.
- Şunu seçin: Run request ve hem HTTP durumunu hem yanıt gövdesini inceleyin.
- Belgelenmiş örneği uygulamanızda güvenli kimlik bilgisi depolamasıyla kullanın.
Playground hesabınızı kullanır. Mesaj gönderen, arama yapan veya hizmet sipariş eden istekler gerçek işlemler yapabilir ve ücret doğurabilir. Ücretsiz bir deneme ortamı olarak görmeyin.
Webhook bildirimleri ekleyin
Hesap entegrasyonlarında bir HTTPS uç noktası ekleyip gereken olayları seçin. Webhook imzalama sırrı API anahtarından ayrıdır. İmzaları doğrulayın, her olayı bir kez işleyin ve alındığını hızlıca bildirin. Sorunlarda teslimat günlüklerini kontrol edin. Ücretli işlemi yinelemeden önce API’nin yeniden deneme ve yinelenen istek kurallarını okuyun; zaman aşımı tek başına başarısızlık kanıtı değildir.
İlgili kılavuzlar
Doğru hizmet başvurusunu seçin
Başvuru Lookup, Pricing, SIP, SMS, Contacts, Speech API, Phone Numbers, Voice API ve Calls & recordings bölümlerini ayırır. Kesin ön koşullar, alanlar ve ücretler için uç nokta belgelerini kullanın. Tarayıcı aramalarının ayrı bir Webphone SDK kılavuzu vardır; sunucu tarafı Voice API çağrı kontrolüyle aynı değildir.
Bir ajanın API belgelerini okuma izni, hesap sahibinin anahtarına veya anahtarla doğrulanan Playground çalıştırmasına erişim sağlamaz. Hesap sahibinin oturumunu paylaşmak yerine entegrasyon kimlik bilgilerini yönetmesini isteyin.
Dönen referansları ve sayfalamayı kullanın
Açık çağrı referanslarını içeriğini yorumlamadan kullanın: kendiniz üretmek veya dahili telefon sistemi kimliği kullanmak yerine yanıtınızdaki tam CALL- referansını kopyalayın. Geçmiş ve etkin çağrılar ayrı listelerdir. Kontrol işlemi desteklenen çağrı durumunu da gerektirir; eski bir geçmiş kaydı mutlaka kontrol edilebilir değildir.
Çağrı geçmişinde pagination.has_more doğru oldukça pagination.next_cursor izleyin. İlk days, limit ve SIP kimliği filtrelerini değiştirmeyin. İmleci çözmeyin veya düzenlemeyin. Süresi dolarsa yeni liste başlatıp açık çağrı referansıyla eşleştirin. UTC olarak belgelenen API zamanı gösterim için bilinçli dönüştürülmelidir; kendiliğinden tarayıcının yerel saati olmaz.
Ücretli işlemleri yinelemeden hataları yönetin
HTTP durumunu ve yapılandırılmış hatayı birlikte okuyun. Yeniden denemeden önce doğrulama veya yetki hatalarını düzeltin. Hız sınırında belgelenen bekleme süresine uyun. Ücretli işlemde zaman aşımı veya geçici hata olursa tekrar göndermeden önce durumunu ve uç noktanın yinelenen istek kurallarını kontrol edin; istek kimliğini değiştirmek yeni bir işlem oluşturabilir. Destek için açık istek/referans, zaman ve hassas bilgilerden arındırılmış hatayı saklayın; API anahtarını asla paylaşmayın.