Kullanılabilir telefon numaralarını bulun

Tekil bir önek seçin

Ülkeleri ve kapsam alanlarını keşfetmeye yönelik çağrıları kullanın; ardından getprefixes çağrısını gruplama yapmadan çalıştırın. Seçilen öneğin şu alanını kopyalayın: uuid. Eğer returns_numbers değeri 0 ise önek, sipariş verildiğinde bir numara atar; tek tek numaraların listesini zorunlu tutmak yerine döndürülen next_function değerini kullanın.

Sınırlı bir sonuç grubuna göz atın

Normal bir arama için compact=1 kullanın ve istediğiniz sonuç grubu boyutunu aşağıda gösterildiği gibi hem yolda hem de quantity sorgu parametresinde belirtin. Sayfa veya imleç parametresi yoktur. Kompakt bir sonuç yalnızca bir örneklemdir; isteği tekrarlamak, önceki sonuçlarla örtüşmeyen bir sonraki sayfayı garanti etmez. Boş veya az sayıda sonuç dönmesini toplam stok miktarı olarak yorumlamayın.

Akılda kalıcı bir rakam deseni bulun

Şu seçeneklerden birini belirtin: number_filter_mode=contains veya ends_with; ayrıca şu parametreyi de sağlayın: number_filter_value. Değer 1–15 rakam içermelidir. Arama, filtreyi uygulamadan önce sınırlı sayıda aday grubu getirebilir; bu nedenle stoktaki diğer eşleşmeleri kaçırabilir. Gerekli aramayı uygulamak için desteklenen bir kaynağa ihtiyacınız varsa MultiTEL'den bir pid seçicisi edinin ve filter_required=1 kullanın; seçim yapılmaması veya desteklenmeyen bir seçim yapılması API hatası döndürür.

Seçilen numarayı inceleyin

Aynı sonuçtan şu bilgileri okuyun: number, info.uuid, seçilen price[].uuid, kullanılabilir özellik adları ve kayıt gereklilikleri. price dizisi, farklı kanal sayıları ve ücretlere sahip birden çok plan sunabilir. Parasal alanlar ve miktarlar metin dizeleri olarak kodlanabilir. info.state dahil isteğe bağlı meta veriler kaynağa göre değişir; tek bir evrensel durum yapısını zorunlu tutmayın veya bir kimlikten fiyat çıkarsamayın.

Akış kullanılmayan işlem yolunda, seçilen sonuç grubu ilk planın aylık fiyatına göre sıralanmadan önce yinelenen adaylar ayıklanır ve kaynaklar arasında tahsis yapılır. Diğer işlem yolları daha erken akış başlatabilir; bu nedenle tüm istekler için geçerli, sonuçların tamamını kapsayan bir sıralama veya yinelenenleri ayıklama garantisi yoktur. Sıralama, döndürülen örneklemin tüm katalogdaki en ucuz numarayı içerdiğini de kanıtlamaz.

Ayrı bir sipariş verin ve sonucu doğrulayın

Arama yapmak herhangi bir şeyi satın almaz veya rezerve etmez. Döndürülen numara ve plan kimliklerini aynı hesap altındaki sipariş iş akışı için saklayın. Siparişi göndermeden önce gerçek planı, gereklilikleri ve ücretleri inceleyin. Kayıt gereklilikleri etkinleştirmeyi geciktirebilir; arama sonucu, etkinleştirme için kesin bir son tarih belirlemez.

İstek

Etkin bir MultiTEL API hesabı kullanın: parolalı bir hesap için HTTP Basic kimlik bilgileri, belirteçli bir hesap için ise Authorization: Bearer kullanın. Hesabın izinleri ve IP kısıtlamaları geçerlidir. Ortak kimlik doğrulama kılavuzuna bakın.

Yol parametreleri ve URL sorgu parametreleri. Genel kullanıma açık arama iş akışı için GET kullanın. İşleyici belirli form/istek değerlerini de kabul eder, ancak JSON gövdeli bir arama API'si değildir.

curl --fail-with-body --get \
  --user "${MULTITEL_API_USERNAME}:${MULTITEL_API_PASSWORD}" \
  --data-urlencode "compact=1" \
  --data-urlencode "quantity=10" \
  "https://api.multitel.net/v3/getnumbers/${PREFIX_ID}/10"

Yanıt

status ve response içeren tek bir JSON nesnesi. Başarılı olduğunda status.code değeri 200 olur ve response numara kayıtlarından oluşan bir dizidir. status.results, döndürülen dizinin eleman sayısıdır; status.msg değeri Results: N veya akışlı bir yanıtta OK olabilir. compact=1 kullanılmadığında bazı aramalar response dizisini aşamalı olarak yazar ve status ile tamamlanır; bu nedenle JSON gövdesinin tamamını bekleyin. Bu, satır sonlarıyla ayrılmış JSON değildir. HTTP aktarımı başarılı olsa bile status.code değerini kontrol edin. Tipik alanlar aşağıda gösterilmiştir; kaynağa özgü meta veriler ve isteğe bağlı alanlar değişiklik gösterir. Hiçbir kimliğin içeriğinden anlam çıkarmayın ve numarayı, onun için seçilen price[].uuid değeriyle birlikte saklayın.

Yanıt yapısını gösteren örnek; canlı hesap verisi veya güncel bir fiyat teklifi değildir.

{
  "status": {
    "code": 200,
    "msg": "Results: 1",
    "results": 1
  },
  "response": [
    {
      "number": "12125550123",
      "info": {
        "uuid": "NUMBER_ID_FROM_RESPONSE",
        "prefix_uuid": "PREFIX_ID_FROM_RESPONSE",
        "area_uuid": "AREA_ID_FROM_RESPONSE",
        "country_uuid": "COUNTRY_ID_FROM_RESPONSE",
        "country_iso": "US",
        "prefix": "+1212",
        "name": "Example area",
        "state": "US"
      },
      "price": [
        {
          "uuid": "PRICE_PLAN_ID_FROM_RESPONSE",
          "per_minute": "0.01",
          "per_sms": "0",
          "per_mms": "0",
          "free_minutes": "0",
          "setup_price": "1.00",
          "monthly_price": "2.00",
          "yearly_price": "0",
          "channels": "2"
        }
      ],
      "contract": {
        "term": "1 month",
        "renewal": "monthly",
        "notice": "none"
      },
      "restrictions": {
        "needs_registration": "0",
        "restrictions": ""
      },
      "features": [
        "voice"
      ],
      "overflow": "0"
    }
  ]
}

Hatalar

• 401: Kimlik doğrulama başarısız oldu. Geçersiz veya eksik kimlik bilgileri ve API hesabına erişimin reddedilmesi durumunda arama sonucu üretilmez.
• 404: Invalid prefix ID, Invalid country, Invalid area veya No numbers found. status.msg alanını okuyun; hata yanıtı bir numara dizisi değildir.
• 400: response.code alanında NUMBER_FILTER_INVALID: geçersiz mod, 1–15 rakam koşulunu karşılamayan bir değer veya mod ve değerin ikisi de sağlanmadan filter_required kullanılması.
• 422: response.code alanında NUMBER_FILTER_UNSUPPORTED: önek numarayı sipariş sırasında atıyordur (reason=order_only_prefix ve next_function sipariş yolunu belirtir) veya açıkça seçilen kaynak gerekli filtreyi destekleyemiyordur.

Kullanılabilirlik ve yan etkiler

• Bu işleyici arama yapar ve fiyat teklifleri hazırlar; numara siparişi göndermez veya numara satın alma ücretini hesaptan düşmez. Katalog önbelleklerini yenileyebilir, önbellekteki güncelliğini yitirmiş stok kayıtlarını kaldırabilir, hesaba özel fiyat planlarını kaydedebilir ve arama günlükleri yazabilir.
• Kullanılabilirlik, belirli bir andaki durumu gösterir; rezervasyon değildir. Daha sonra verilen bir sipariş başarısız olabilir veya farklı bir kullanılabilirlik durumu döndürebilir. Satın alma işlemini yeniden denemeden önce sipariş sonucunu kayıtlarınızla karşılaştırıp işlemin durumunu netleştirin.
• Fiyatlar hesaba özeldir. Seçilen plan kimliğini aynı hesap için saklayın ve sipariş koşullarıyla ücretleri ayrıca inceleyin; bu uç nokta tek başına bir fiyatın daha sonraki bir siparişe kadar geçerli kalacağını kanıtlamaz.
• Örnek numara ve fiyatlar, yanıt yapısını göstermek için oluşturulmuş kurgusal örneklerdir; canlı bir fiyat teklifi değildir. Özellikler, kanal sayıları, sözleşme süresi ve kayıt bilgileri, gerçekten seçilen sonuçtan okunmalıdır.
• Bazı kayıt açıklamaları biçimlendirilmiş metin veya bağlantılar içerir. Döndürülen metin dizelerini kendi uygulamanızda görüntülerken güvenilmeyen veri olarak ele alın.
• Mobil kullanılabilirlik ve ilgili bayraklar, hesabın uygunluğuna ve stoka bağlıdır. Katalogdaki bir önek veya is_mobile bayrağı tek başına belirli bir numaranın mobil özelliklerini ortaya koymaz.