REST API belgeleri
Telefon numarası REST API’leri
Mevcut ülkeleri ve numaraları keşfedin, teklifin tamamını inceleyin ve sahip olduğunuz numaraları yönetin.
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.
Kullanılabilir ülke kataloğunu okuyun
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/getcountries"v3 yanıtı status ve bir response dizisi içerir. Ülke girdileri isocode, name, countrycode, yetenek bilgileri ve next_function alanlarını içerir. Kullanılabilirlik hesaba ve envantere bağlıdır; bir ülkenin listelenmesi, her önekin veya numara türünün stokta olduğu anlamına gelmez.
{
"status": {
"code": 200,
"msg": "Results: 1"
},
"response": [
{
"countrycode": "1",
"name": "United States",
"description": "United States",
"isocode": "US",
"is_mobile": 0,
"sms_coverage": 1,
"latitude": "37.0902",
"longitude": "-95.7129",
"next_function": "v3/getareas/US"
}
]
}Keşiften etkinleştirmeye
- İlgili coğrafya işlemlerini kullanarak ülkeyi, gerekiyorsa alt bölümü, bölgeyi ve numara türünü seçin.
- Seçilen numaranın kurulum, aylık ve kullanım fiyatlarını, kanallarını, kullanım hakkını ve kayıt gereksinimlerini okuyun.
- Gerekli son kullanıcı belgelerini gönderin ve durumlarını inceleyin. Bir numara onaya kadar beklemede kalabilir.
- Tam envanter ve fiyat seçimiyle bir kez sipariş verin. Yanıt belirsizse başka bir sipariş göndermeden önce envanterinizi inceleyin.
- Sesli yönlendirmeyi ve mesaj teslimini birbirinden bağımsız olarak yapılandırın, ardından amaçlanan rotanın tamamını test edin.
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.