Bir ön ekten telefon numaraları sipariş edin

Bir ön ekten sipariş verin

Ön ek kataloğu sizi kullanılabilir numaraları tek tek seçmek yerine bir ön ekten belirli sayıda numara sipariş etmeye yönlendirdiğinde bu işlemi kullanın. Başlangıç için şunlara bakın: ülkeler, bölgeler veya eyaletler ve ön ekler. Ön ek tanımlayıcısını ve fiyat planını aynı güncel sonuçtan alın ve saklayın. Kullanılabilir numaralar listesinden seçtiğiniz belirli bir numara için şu işlemi kullanın: Seçilen bir telefon numarasını satın alın.

Bu istek numara satın alabilir ve ücret doğurabilir. Bir fiyat teklifi, rezervasyon veya deneme işlemi değildir. Göndermeden önce kurulum ve aylık ücretleri, gelen aramaların dakika ücretlerini, pakete dâhil dakikaları, kanalları, kayıt gerekliliklerini ve hesabın satın alma sınırlarını inceleyin. Katalog sonucu envanteri rezerve etmez veya fiyatları sabitlemez. Hesaba bakiye yükleme kontrolleri sipariş karşılanmadan önce yapılabilir; bir hata, tek başına hiçbir satın alma veya hesaba bakiye yükleme işlemi gerçekleşmediğini kanıtlamaz.

Satın alma isteğini gönderin

İzin verilen bir kaynak IP adresinden HTTPS üzerinden etkin bir API hesabı kullanın. Değişkenleri güncel katalog seçiminize ve onaylanmış iletim yapılandırmanıza göre ayarlayın. Aşağıdaki komut bir numara satın alır.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode 'quantity=1' \
  --data-urlencode "price_id=$PRICE_ID" \
  --data-urlencode "channels=$CHANNELS" \
  --data-urlencode "reference=$ORDER_REFERENCE" \
  --data-urlencode "uri=$VOICE_URI" \
  "https://api.multitel.net/v3/order/$PREFIX_ID"

Yukarıda form verileriyle POST kullanımı gösterilmiştir. Koordinatör, Content-Type değeri application/json olduğunda bir JSON nesnesini de okur. JSON alanları, eşleşen form/istek alanlarının üzerine yazılır. Tutarlı biçimde tek bir kodlama kullanın; birbiriyle çelişen sorgu ve gövde değerleri göndermeyin.

İletim ve yenileme ayarları

Numara için portalda kullanacağınız iletim ayarlarının aynısını seçin. Bunlar gelişmiş yapılandırma değerleridir; barındırılan bir PBX veya gelen arama trunk'ı oluşturma talimatları değildir. Çalıştığı bilinen bir hesap yapılandırmasını yeniden kullanın ve satın alma sonrasında kaydedilen numarayı doğrulayın. Satın almanın kabul edilmiş olması tek başına ses veya SMS iletiminin çalıştığını doğrulamaz.

Bu alanlar standart biçime dönüştürülerek satın alma işlemine aktarılır, ancak kalıcı olarak kaydedilmeleri envanter akışına göre değişir. Mevcut sipariş rotası, seçilen numarayı satın alma kılavuzundaki kesin teklif üst sınırı alanlarını eşdeğer korumalar olarak sunmaz. Hesabın satın alma izinlerini ve fiyat sınırlarını kullanın ve oluşan numara yapılandırmasını inceleyin.

Sonucun tamamını okuyun

HTTP isteği başarılı olsa bile JSON gövdesini ayrıştırın ve status.code ile status.msg alanlarını inceleyin. Bu rota kendi JSON yanıtını yazar; ortak yanıt yardımcısı da uygulama kodunu HTTP durumuna her zaman eşlemez. Uygulama kodları JSON sayıları veya sayısal dizeler olabilir. status.results alanını zorunlu tutmayın; normal sipariş sonucunda bulunmaz.

{
  "status": {"code": "200", "msg": ""},
  "response": {
    "id": "o_fictional_example",
    "numbers": ["12025550123"],
    "price": {
      "per_minute": "0.01",
      "free_minutes": 0,
      "setup_price": "1.25",
      "monthly_price": "2.50",
      "channels": 2
    },
    "features": ["voice"],
    "needs_registration": 0,
    "restrictions": "",
    "registration_requirements": null
  }
}

Yukarıdaki tanımlayıcı, numara ve fiyatlar kurgusaldır. Sipariş kimliğinin iç yapısına anlam yüklemeyin. numbers, bu yanıtta satın alındığı bildirilen numaraları listeler; listenin uzunluğunu istediğiniz adetle karşılaştırın. Fiyat tutarları dize biçimindedir ve bu yanıt, per_minute dâhil parasal ücretleri iki ondalık basamağa yuvarlar; ücretlerin özgün hassasiyeti için güncel kataloğu kullanın. Pakete dâhil dakikalar ve kanallar, sayısal değerler veya sayısal dizeler olarak gelebilir.

Fiyat bloğu, her numaranın ayrıntılı faturasını veya sipariş toplamını değil, yanıtı oluşturmak için kullanılan seçili planı açıklar. Envanterdeki farklı adayların planları farklı olabilir. Bu bloktaki tutarları çarparak nihai toplamı kanıtladığını varsaymak yerine, satın alınan numaraları tek tek ve hesap işlemlerini karşılaştırarak mutabakat sağlayın.

Kısmi satın almalar ve belirsiz sonuçlar

200 uygulama koduna bir uyarı ve istenenden daha az numara eşlik edebilir. Daha sonra oluşan bir hata, önceden satın alınmış numaraları geri almaz. Döndürülen sipariş kimliğini, numaraları ve mesajı saklayın. Kalan adet için sipariş verip vermemeye karar vermeden önce bu numaraları envanterinizdeki kayıtlarla ve hesap işlemleriyle karşılaştırarak mutabakat sağlayın.

İstek gönderildikten sonra zaman aşımı, bağlantının kesilmesi, bozuk yanıt veya hata oluşması, hiçbir şey gerçekleşmediğinin kanıtı değildir. Aynı referansla bile olsa otomatik olarak başka bir satın alma isteği göndermeyin. İlk isteği, referansı ve döndürülmüşse sipariş kimliğini saklayın, envanteri ve hesap işlemlerini kontrol edin ve sonuç belirsiz kalıyorsa destek ekibiyle iletişime geçin.

Henüz onaylanmamış bir sipariş, onaylama işleminin sürdüğünü belirten bir mesajla 400 uygulama kodunu döndürebilir. Döndürülen sipariş kimliğini saklayın ve bu satın almayı kayıtlarla karşılaştırarak mutabakat sağlayın; bu, isteği yeniden gönderme talimatı değildir. Kayıtlı siparişleri kurtarma mekanizması, ilk siparişi sistem içinde izler. Bu işleme gönderilen yeni bir istek, referansınıza göre bir siparişi sürdürmek yerine ayrı bir satın alma girişimi oluşturur; dolayısıyla daha fazla numara satın alabilir ve bunlar için ücret doğurabilir. Durumu kontrol etmek veya envanterde arama yapmak için tekrarlanan satın alma istekleri kullanmayın.

Kayıt ve etkinleştirme

Satın alınan veya tahsis edilen bir numara için hâlâ kayıt veya etkinleştirme gerekebilir. needs_registration değeri 1 ise restrictions ve registration_requirements alanlarını inceleyin. Sonuncusu şu uç noktayı belirtebilir: v3/get_requirements; beraberinde country ve number_type değerlerini de sağlayabilir. Gelen aramalara veya mesajlaşmaya güvenmeden önce ilgili kimlik/adres iş akışını tamamlayın ve numaranın durumunu doğrulayın.

features, sunulduğu belirtilen özellikleri açıklar; canlı yönlendirmeyi, kampanya onayını, SMS iletimini veya faks alımını doğrulamaz. Kaydedilmiş iletim ayarlarını kontrol edin ve numara etkin olduğunda uygun hizmet testini yapın.

Sipariş geri çağrıları

Geri çağrılar, sipariş durumunu ve yanıtını içeren JSON verisini POST yöntemiyle gönderir; sağlanmışsa referansınız da eklenir. Kısmi sonuçlar dâhil, bildirilen satın almalar için gönderilirler. Başarısız bir geri çağrı, satın almayı geri almaz. İletim yeniden denenebilir; bu nedenle başka bir satın alma isteği göndermek yerine yinelenen bildirimleri sipariş kimliğine göre işleyin ve numaraları kayıtlarla karşılaştırarak mutabakat sağlayın.

Bu rota kriptografik bir geri çağrı imzası eklemez. Geri çağrıyı, ücretlendirme, hizmet tahsisi veya erişim izni verme için bağımsız bir yetkilendirme olarak değil, kimlik doğrulamasıyla eriştiğiniz envanterle karşılaştırıp mutabakat sağlamak için bir bildirim olarak değerlendirin. API kimlik bilgilerini geri çağrı URL'sine koymayın. Farklı bir geri çağrı URL'siyle başka bir satın alma isteği göndermek ilk siparişi güncellemez; ayrı bir satın alma girişimi oluşturur. Destek ekibinden geri çağrıyı incelemesini isterken ilk siparişin kimliğini saklayın.

Ele alınması gereken hatalar