REST API belgeleri
LRN yönlendirme sorgusu REST API’si
Bir Kuzey Amerika telefon numarasının yönlendirme numarasını ve mevcut operatör bilgilerini sabit bir fiyatla sorgulayın.
API’yi ve kimlik bilgisini birlikte seçin
Onaylı Geliştirici ve Otomasyon, İşletme ve İletişim Sağlayıcısı hesapları etkinleştirilmiş hizmetleri entegre edebilir. Bireysel bir geliştiricinin şirket gibi davranması gerekmez. Uygulama SMS/MMS’i için geçerli gönderim onayı ve kayıt gerekir. Bireyler ve aileler hizmetinde müşterinin erişebileceği, mesaj gönderimini başlatan bir API yoktur.
| API ailesi | Temel URL | Kimlik doğrulama ve sonuç |
|---|---|---|
| İletişim v3 | https://api.multitel.net/v3 | Onaylı Basic kimlik bilgileri; uygun şekilde sağlanmış belirteçler yalnızca bunları destekleyen işlemlerde. JSON status ve response. |
| Acil durum kaydı | https://api.multi.tel/emergency | Onaylı Basic kimlik bilgileri veya özel olarak sağlanmış bearer erişimi. JSON code, message ve data. |
| Portal REST entegrasyonları | Hesabınızın geliştirici başvuru kaynağında gösterilen ana bilgisayar ve işlem | Bu işlemin belgelenmiş kimlik bilgisini, kapsamlarını ve şemasını kullanın. Tarayıcı oturumu istekleri ayrı bir erişim yoludur. |
Örnekleri kullanmadan önce MULTITEL_API_USERNAME ve MULTITEL_API_PASSWORD değerlerini sunucunuzun gizli bilgi yapılandırması üzerinden ayarlayın. Bunları asla herkese açık tarayıcı JavaScript’ine, URL’lere veya kaynak denetimine eklemeyin. Özel kimlik bilgileri API Entegrasyonu ayarları bölümünde yönetilir.
Bir numarayı sorgulama
GET /v3/lrn/{number} hedef numarayı yolda kabul eder. Kaynağa bağlı bilgiler için isteğe bağlı bir arayan numarası /v3/lrn/{number}/{ani} olarak sağlanabilir. Uygulanabildiği yerlerde ülke koduyla birlikte Kuzey Amerika rakamlarını kullanın; örneklerde ayrılmış kurgusal numaralar kullanılmıştır.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/lrn/12025550123"curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/lrn/12025550123/12025550124"Geçerli kimlik bilgileriyle sorgu yapmak faturalandırılır. Ücret sorgu başına $0,00025: 1.000 sorgu için $0,25 veya milyon sorgu için $250. Hacim indirimi yoktur. Bu bir yönlendirme bilgisi sorgusudur; telefon araması yapmaz.
Sonucu okuyun
{
"status": {
"code": 200,
"msg": "Success"
},
"response": {
"lrn": "12025550123",
"ported": 0,
"ocn": "",
"lata": "",
"rc": "",
"cost": "$0.00025"
}
}Bu uydurma örnek yalnızca yanıtın yapısını gösterir; ölçülmüş bir yönlendirme sonucu değildir. response alanını kullanmadan önce status.code değerini kontrol edin. cost alanı JSON sayısı değil, para birimi önekli bir dizedir.
| Alan | Anlamı |
|---|---|
lrn | Yönlendirme hedefini belirlemek için kullanılan Location Routing Number. |
ported | Bu sorgunun sağladığı taşınabilirlik göstergesi: genellikle 0 veya 1. Bunu sahiplik veya hizmet uygunluğu kanıtı olarak kullanmayın. |
ocn | Sağlandığında Operating Company Number. |
lata | Sağlandığında Local Access and Transport Area. |
rc | Sağlandığında tarife merkezi (rate center). |
city, state, lec, lectype, jurisdiction, local | Mevcut olduğunda ek konum, operatör veya kaynakla ilgili ayrıntılar. Bunlar bulunmayabilir veya boş olabilir. |
Her yönlendirme alanının mevcut olmasını zorunlu tutmayın. Özellikle ücretsiz arama numarası sonuçlarında yerel tarife merkezi ve operatör kodu ayrıntıları bulunmayabilir. Döndürülen bir LRN, erişilebilirliğin gerçek zamanlı garantisi veya arama kalitesi testi değildir.
Sorguları yönlendirme iş akışınızda kullanın
- İstenen numarayı göndermeden önce doğrulayın ve normalleştirin.
- HTTP ve uygulama durumunu inceleyin. Sorun giderme için numaranın, zamanın ve sonucun bilgileri çıkarılmış bir kaydını saklayın.
- Yalnızca yönlendirme kuralınızla ilgili alanları kullanın ve bulunmayan değerleri açıkça ele alın.
- Belirsiz bir yanıttan sonra yeniden denemeleri sınırlayın. Bir sorguyu tekrarlamak yeni bir ücrete yol açabilir; bu uç noktanın belgelenmiş bir idempotency anahtarı yoktur.
LRN ürününe ve sabit fiyatlandırmaya bakın. Herkese açık OpenAPI yolu bir ANI bölümü içerir; yayınlanmış LRN uygulaması ANI içermeyen daha kısa isteği de kabul eder. lrninfo ayrı bir işlemdir ve bu uç nokta yerine kullanılmamalıdır.
Hataları ve yeniden denemeleri yönetme
- Kimlik doğrulama veya yetki hatası
- API kimlik bilgisinin etkin olup olmadığını, izin verilen hizmeti ve kaynak IP kısıtlamasını kontrol edin. Portal oturum çerezi bir entegrasyon kimlik bilgisi değildir.
- Yetersiz kredi veya eksik onay
- İşlemi tekrarlamadan önce hesap bakiyesi, gönderim onayı veya belge gereksinimini çözün.
- Sonuç yok
- Boş envanteri veya bulunamayan arayan adını olağan bir sonuç olarak ele alın. Sözdizimi geçerli bir numaranın her hizmete sahip olduğunu varsaymayın.
- Ağ zaman aşımı veya hizmet hatası
- Okuma işlemlerinde geri çekilmeli (backoff) ve sınırlı sayıda yeniden deneme kullanın. Satın alma, gönderim veya kayıt işlemlerinde önce işlemin durumunu inceleyin; kabul edilmiş bir isteği yeniden denemek faturalandırılabilir bir işlemin tekrarlanmasına yol açabilir.
Idempotency desteği her API ailesine özgüdür. Acil durum API’si yeniden deneme anahtarlarını destekler; bu, v3 isteklerinin keyfi olarak idempotent olduğu anlamına gelmez. Destek için zaman damgalarını, döndürülen kimlikleri ve bilgileri çıkarılmış yanıtları saklayın.
Hesabınızın referansıyla devam edin
Oturum açılmış referans, işlemleri izinlerinize ve etkinleştirilmiş hizmetlerinize göre filtreler. Onun belirttiği ana makine adını, kimlik bilgisi türünü, istek alanlarını ve yanıt şemasını aynen kullanın. Konsollar, satın alma ve mesaj gönderme dahil canlı işlemleri çalıştırabilir.