Hesap ve proje erişimi
İ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ği veya bir telefon numarası yerine, 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"Bu yanıtı gizli bilgi olarak işleyin
Tam yanıt, numaranın ayrıldığı operatöre ilişkin faturalandırma bilgilerini içerir. Bunlar arasında saklanan şu bilgiler bulunur: billing_pin, faturalandırma hesabı, telefon, adres, şirket ve yetkili irtibat kişisinin bilgileri. API bu alanları maskelemez. İş akışınız için yalnızca durum veya numara listesi yeterliyse sadece bunları isteyin. Tam ayrıntı yanıtını tarayıcı depolamasına, analiz sistemlerine, herkese açık günlüklere veya destek için alınan ekran görüntülerine dahil etmeyin ve yalnızca yetkili müşterinin ihtiyaç duyduğu alanları gösterin.
Yanıt yapısı
Seçilmiş alanları içeren kurgusal örnek; yanıtta ek alanlar da döndürülebilir.
{
"status": {
"code": 200,
"msg": "Project Detail"
},
"response": {
"project": {
"id": 11,
"uniqueid": "PROJECT_EXAMPLE",
"project_name": "Example transfer",
"location": "US",
"status": 0,
"status_str": "Pending"
},
"counts": {
"total": 0,
"pending": 0,
"in_progress": 0,
"completed": 0,
"rejected": 0
},
"numbers": [],
"events": [],
"uploads": []
}
}Bilerek kısmi tutulan bu örnekte, faturalandırmaya ilişkin tüm kimlik doğrulama bilgileri ve kişisel iletişim değerleri dışarıda bırakılmıştır. Örnekte yer almamaları, gerçek yanıtta bu bilgilerin gizlendiği anlamına gelmez.
| Bölüm | İçerik |
|---|---|
| project | Sayısal satır kimliği, benzersiz proje kimliği, proje adı, konum, saklanan faturalandırma, iletişim ve adres verileri, oluşturulma zamanı ve türetilmiş durum. Numaranın ayrıldığı operatörü belirten eski alanın yazımı loosing_carrier şeklindedir. |
| counts | Toplam numara satırı sayısı ve Pending, In Progress, Completed ve Rejected sayaçları. |
| numbers | Müşteri yorumları ve saklanan zamanlama değerleri dahil olmak üzere, projenin numara listesi uç noktasında sunulanlarla aynı numara alanları. |
| events | Olay uç noktasının görünürlük ve biçim kısıtlamalarına tabi olan, saklanmış olay satırları ve ham ya da ayrıştırılmış veri yükü alanları. |
| uploads | Belge meta verileri: sayısal kimlik, upload_type, file_name, file_extension, date_created ve göreli bir download_url. URL için yine de hesap kimlik doğrulaması gerekir. |
Özeti ve meta verileri yorumlama
Türetilmiş durumda öncelik sırası In Progress, ardından Pending, sonra Completed ve son olarak Rejected şeklindedir; hiçbiri uygulanamıyorsa Pending kullanılır. Özet durumu Completed olduğunda da reddedilmiş numaralar bulunabilir. Her numaranın taşıma işleminin tamamlandığını varsaymak yerine sayaçları ve numara durumlarını inceleyin.
Yanıt dosya baytlarını değil, belge meta verilerini içerir. Sayfalama veya artımlı sorgulama imleci yoktur. Ayrıntı ve liste sorguları ayrı okuma işlemleridir; işlem düzeyinde tutarlılığı garanti edilen tek bir anlık görüntü oluşturmazlar. Tarihler, belgelenmiş bir saat dilimi dönüşümü olmadan saklandıkları değerlerle kalır. Proje yollarında uniqueid kullanın; sayısal proje kimliği bunun yerine kullanılamaz.
Hatalar ve sınırlar
Hem HTTP yanıtını hem de şu alanları kontrol edin: status.code/status.msg. Bulunmayan, silinmiş veya hesaba ait olmayan bir proje için, projenin bulunamadığını belirten bir mesajla birlikte 404 API kodu döndürülür. Kimlik doğrulama ve kaynak IP kısıtlamaları da geçerlidir. Örnekler canlı bir istek göndermez; başarılı bir yanıt, operatörün taşıma işlemini kabul ettiğinin veya tamamladığının kanıtı değildir.
Etkiler ve iş akışı
Bu, mevcut portalın numara taşıma siparişi görünümünde kullandığı esas ayrıntı yoludur. Portal, alanları kullanıcı arayüzüne uyarlar ve müşteriye sunulacak alanları kendi kurallarına göre seçer; ham API yanıtının portalın JSON verileriyle veya gösterimiyle aynı olduğunu varsaymayın. İncelenen ayrıntı işleyicisi projeyi değiştirmez ve doğrudan bir operatör isteği ya da ücret tahsilatı başlatmaz.