Kayıtlı sahibi, API kimlik bilgilerinizin temsil ettiği hesapla eşleşen satın alınmış numara kayıtlarını listeleyin. Bir kaydın mevcut olması, canlı arama testinin başarılı olduğu anlamına gelmez.
İstek
Sunucu tarafındaki API kimlik bilgilerini HTTPS üzerinden kullanın. Örnekler kimlik bilgilerini ortam değişkenlerinden okur; geçerli kimlik bilgileri içermez. JSON gövdesindeki status.code değerini ve HTTP durumunu inceleyin. Bu eski işleyiciler, uygulama hataları için her zaman bir HTTP hata durumu ayarlamaz.
curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
"https://api.multitel.net/v3/inventory"Tek bir kayıtlı telefon numarasına göre filtrelemek için isteğe bağlı yol biçimini kullanın:
curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
"https://api.multitel.net/v3/inventory/12025550100"Kayıtlı uluslararası telefon numarasını, ülke kodu dahil yalnızca rakamlardan oluşacak şekilde kullanın. Bunun yerine PBX dahili numarası, numara UUID değeri, bölge kimliği veya önek kimliği göndermeyin. Sağlanan numara mevcut bir kaydı seçer; numara satın almaz veya yapılandırmaz.
Yanıt
Başarılı bir yanıtta response üyesi, tek numaralı yol biçiminde de her zaman bir dizidir. status.results dizinin uzunluğudur.
Bu, yanıt yapısını göstermek için verilen bir örnektir; hesap verisi veya güncel bir fiyat teklifi değildir.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"number": "12025550100",
"uuid": "NUMBER_UUID",
"description": "Main reception",
"isocode": "US",
"config": {
"uri": "sip:reception@example.com",
"uri2": "",
"uri3": "",
"forward_destination": "",
"sms_uri": "",
"sms_forward_destination": ""
},
"features": {
"voice": "1",
"sms": "1",
"mms": "0"
},
"status": {
"capacity": {
"assigned_channels": "2",
"used_channels": "0",
"overflow": "0",
"overage_charge": "0.01"
},
"origination": {
"origination_trunk_id": "ORIGINATION_ID",
"origination_trunk_name": "ORIGINATION_NAME",
"origination_country_iso": "US",
"origination_continent_iso": "NA",
"origination_continent_name": "North America"
},
"service_active": "1",
"force_codec": "",
"force_dtmf": ""
},
"billing": {
"cnam": "0",
"overflow": "0",
"autorenew": "1",
"persistent": "0",
"date_created": "2026-01-01 00:00:00"
},
"price": {
"setup_price": "0.00",
"monthly_price": "1.00",
"per_minute": "0.01",
"free_minutes": "0",
"remaining_minutes": "0"
}
}
]
}| Alan | Anlamı |
|---|---|
number, uuid, description, isocode | Kayıtlı telefon numarası, iç yapısından anlam çıkarılmaması gereken numara tanımlayıcısı, açıklama ve ülke kodu. |
config | Kayıtlı ses hedefleri, harici yönlendirme, SMS hedefi ve SMS yönlendirme alanları. Bu uç nokta bu alanları değiştirmez. |
features | Kayıtlı ses, SMS ve MMS yetenek bayrakları. Eski sistemden kalan kayıtlı bayrakların JSON mantıksal değerleri olması garanti edilmez. |
status.capacity | Atanmış ve kullanılan kanal değerleri, taşma ayarı ve kayıtlı aşım ücreti. Bunlar kayıtlı üst verilerdir; güncel bir kapasite teklifi veya canlı arama testi değildir. |
status.origination | Kayıtlı çağrı çıkış noktası üst verileri. Tanımlayıcıların iç yapısından anlam çıkarmayın; dahili adlardan uygulama mantığı türetmeyin. |
status.service_active, force_codec, force_dtmf | Kayıtlı etkinleştirme ve medya yapılandırma alanları. Tek başına bir bayrak, gelen çağrıların başarıyla ulaştırıldığını kanıtlamaz. |
billing | Kayıtlı CNAM, taşma, yenileme, kalıcılık ve oluşturulma değerleri. Bunları okumak, yenileme veya diğer faturalandırma ayarlarını değiştirmez. |
price | Kayıtlı kurulum, aylık ve dakika başına ücretler ile dakika hakları. İşleyici, para birimi alanı veya güncel bir teklif sağlamaz. Örnek değerlerden para birimi çıkarsamayın ve bu değerleri güncel bir satın alma teklifi olarak kullanmayın. |
Filtreleme ve sayfalama
Bu işleyicide sayfalama, sayfa boyutu sınırı veya açıkça belirlenmiş bir sıralama düzeni yoktur. Sorgusunun seçtiği, geçersiz kılınmamış tüm kayıtları döndürür. Yalnızca hizmeti etkin olan kayıtları seçen bir filtre veya arşivlenmiş numaralar için ayrı bir görünüm sunmaz. Döndürülen kayıtların sırasının sabit olduğunu varsaymayın.
Eşleşen numara yok
Hesapta eşleşen, geçersiz kılınmamış kayıt yoksa JSON gövdesindeki status.code değeri 404 olur ve mesaj no numbers found ifadesini içerir. Başarılı bir yanıt olarak boş bir dizi döndürülmez. Mesaj, kaynak referansı içeren bir son ek barındırır; istemciler bu son eki sabit bir tanımlayıcı olarak ayrıştırmamalıdır.
Sonraki adımlar
Tek bir numara için numberinfo işlevini, eski sistemden kalan ek kayıt ve numara referansı alanlarına ihtiyaç duyduğunuzda kullanın. Ayrı bir yapılandırma işlemiyle herhangi bir yönlendirmeyi değiştirmeden önce ses ve mesajlaşma hedeflerini inceleyin.