Hesaba ve projeye erişim
İzin verilen bir IP adresinden HTTPS üzerinden etkin bir API hesabı kullanın. Proje bu hesaba ait olmalı ve silinmiş olmamalıdır. Numara taşıma siparişi iş akışındaki benzersiz proje kimliğini kullanın; projenin sayısal veritabanı kimliğini veya bir telefon numarasını kullanmayın. Bir istek oluştururken proje kimliğine URL kodlaması uygulayın.
İstek
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"Yanıt
Kurgusal yanıt örneği.
{
"status": {
"code": 200,
"msg": "Project Numbers",
"results": 1
},
"response": [
{
"id": 21,
"number": "12025550123",
"status": 0,
"status_str": "Pending",
"isocode": "US",
"updated": "2026-10-23 12:00:00",
"foc": "",
"comment": "Example customer-visible note",
"date_created": "2026-10-23 12:00:00",
"date_completed": ""
}
]
}response bir listedir. Numarası olmayan mevcut bir proje, 200 API koduyla boş bir liste döndürür ve status.results değeri 0 olur. Var olmayan projeler ise 404 API kodunu döndürür.
Numara alanları
| Alan | Anlamı |
|---|---|
| id, number, isocode | Sayısal satır kimliği, saklanan telefon numarası metni ve ülke kodu. Satır kimliği proje kimliği değildir. |
| status, status_str | Sayısal durum ve bilinen etiketi. |
| foc | Kesin sipariş taahhüdüne ilişkin saklanan zamanlama değeri. Boş olabilir; işleyici bunu belgelenmiş bir saat dilimine veya zaman damgası biçimine dönüştürmez. |
| updated, date_created, date_completed | Saklanan güncelleme, oluşturma ve tamamlanma değerleri. Boş değerleri açıkça ele alın; ISO8601 biçimini varsaymayın veya kurgusal örnekten bir saat dilimi çıkarmayın. |
| comment | Müşteriye yönelik saklanan yorum. Bunu çalıştırılabilir HTML olarak değil, metin olarak gösterin. |
Bu veri görünümü, yalnızca personele yönelik internal_comment alanını içermez. Bu, tek bir numaraya yönelik ayrı eski sorgunun aynı veri görünümünü kullandığı anlamına gelmez.
Sıralama ve izleme
Sorgu, oluşturulma zamanına göre artan sıralama yapar. Oluşturulma zamanları aynı olan satırlar için ek bir sıra garantisi yoktur. Sayfalama, artımlı imleç veya tarih filtresi yoktur. Bir projenin verilerini uzlaştırmak için listenin tamamını okuyun ve mevcut satır sayısını kalıcı bir katalog olarak değerlendirmeyin.
Numara taşıma durumunu yorumlama
| Değer | Etiket |
|---|---|
| 0 | Pending |
| 1 | In Progress |
| 2 | Completed |
| 9 | Rejected |
Sayısal durumu koruyun ve bilinmeyen değerleri ele alın. Bilinmeyen etiketlerde yeni bir etiket garantisi yerine saklanan değer kullanılır. Saklanan bir tamamlanma durumu veya planlanmış tarih, tek başına gelen çağrı yönlendirmesini ya da numaradaki tüm hizmetleri test etmez.
Hatalar ve sınırlar
Hem HTTP yanıtını hem de status.code/status.msg değerlerini kontrol edin. Var olmayan, silinmiş veya hesaba ait olmayan bir proje, proje bulunamadı mesajıyla 404 API kodunu döndürür. Kimlik doğrulama ve kaynak IP kısıtlamaları da geçerlidir. Örnekler canlı bir istek yapmaz ve başarılı bir yanıt, bir operatörün aktarımı kabul ettiğini veya tamamladığını kanıtlamaz.
Etkiler
İncelenen işleyici yalnızca projeyi ve projenin saklanan numara satırlarını okur. Yanıt bir anlık görüntüdür; operatör onayı veya canlı hizmet testi değildir. Numara taşıma başlatmaz, yönlendirmeyi değiştirmez ve hesabı borçlandırmaz.