Bir numara taşıma projesinin durumunu kontrol edin

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. Projenin sayısal veritabanı kimliğini veya bir telefon numarasını değil, numara taşıma siparişi iş akışındaki benzersiz proje kimliğini kullanın. İsteği 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/status"

Bu uç nokta istek gövdesi, sayfalama parametreleri veya tarih filtresi okumaz.

Yanıt

Kurgusal yanıt örneği.

{
  "status": {
    "code": 200,
    "msg": "Project Status"
  },
  "response": {
    "uniqueid": "PROJECT_EXAMPLE",
    "status": 2,
    "status_str": "Completed",
    "counts": {
      "total": 2,
      "pending": 0,
      "in_progress": 0,
      "completed": 1,
      "rejected": 1
    }
  }
}

Dıştaki status.code API sonucunu bildirir. Ayrı olan response.status ise projenin hesaplanarak elde edilen numara taşıma özetidir. İkisini birbirine karıştırmayın.

Özet, tüm numaraların ortak sonucu değildir

Özet, herhangi bir numara bu durumdaysa In Progress değerini seçer; aksi halde sırasıyla Pending, Completed ve Rejected durumlarından numarası bulunan ilkini seçer. Bilinen durumlarla eşleşme yoksa varsayılan değer Pending olur. Bu nedenle hem taşıması tamamlanmış hem de reddedilmiş numaralar içeren bir proje, hâlâ reddedilmiş numaralar içermesine rağmen Completed bildirir.

Projenin tamamının bittiğine karar vermeden önce her zaman sayıları ve tek tek numaraların listesini inceleyin. counts.total projedeki numaralara ait tüm satırları kapsar; diğer sayaçlar yalnızca bilinen dört durum değerini kapsar ve başka değerler varsa bunların toplamı genel toplama eşit olmayabilir. Hiç numara içermeyen bir projede tüm sayaçlar sıfır, özet ise Pending olur.

Numara taşıma durumunu yorumlama

Sayısal durum değerini koruyun ve bilinmeyen değerleri de işleyebilin. Bilinmeyen etiketler için yeni bir etiket garanti edilmez; bunun yerine saklanan değer kullanılır. Saklanan bir tamamlanma durumu veya planlanan tarih, tek başına gelen çağrı yönlendirmesini ya da numaradaki tüm hizmetleri test etmez.

Hatalar ve sınırlar

HTTP yanıtıyla birlikte şu alanları da kontrol edin: status.code/status.msg. Mevcut olmayan, silinmiş veya hesaba ait olmayan bir proje, projenin bulunamadığını belirten bir mesajla birlikte 404 API kodunu döndürür. Kimlik doğrulama ve kaynak IP kısıtlamaları da geçerlidir. Örnekler canlı istek göndermez ve başarılı bir yanıt, bir operatörün numara taşıma işlemini kabul ettiğinin veya tamamladığının kanıtı değildir.

Etkiler

Bu uç nokta, proje için saklanan sayıları okur. İncelenen işleyicide numara taşıma talebi göndermez, durum değiştirmez, çağrı başlatmaz veya hesaptan ücret düşmez. Gerçek zamanlı operatör durumu sorgulaması ya da webhook aboneliği sağlamaz.