Geliştiriciler

GET/v3/countries

Katalogdaki ülkeleri listeleme (eski biçim)

GET /v3/other/{isocode} tarafından kullanılan özel numara kataloğuna bağlı, görünür ülkeleri {code, data} gövdesinde döndüren eski uç nokta. Stok kontrolü yapmaz. Stokta numarası bulunan ülkeleri bulmak için GET /v3/getcountries uç noktasını kullanın.

Bu sayfada
  1. İstek
  2. Yanıt
  3. Hatalar
  4. Kullanılabilirlik ve yan etkiler

Bu eski uç nokta, {"code", "data"} gövdesini standart status/response zarfı yerine döndürür. Özel numara kataloğuna bağlı, görünür ülkeleri listeler ve stok kontrolü yapmaz.

Yeni entegrasyonlar için:

  • Şu uç noktayı kullanın: GET /v3/getcountries; bu uç noktayla stokta numarası bulunan ülkeleri bulabilirsiniz.
  • Şu uç noktayı kullanın: GET /v3/other/{isocode}; bu uç noktayla bir ülkede gerçekte hangi özel numara türlerinin sunulduğunu görebilirsiniz. Burada listelenen bir ülke için o uç nokta yine de boş bir katalog döndürebilir.

İstek

Gerekli: HTTP Basic kimlik doğrulaması veya Bearer belirteci (bkz. Kimlik doğrulama ve API yanıtları). Kimlik doğrulama başarısız olursa sorgu çalıştırılmadan önce standart zarfta HTTP 401 yanıtı döndürülür.

Parametresiz ve gövdesiz GET isteği.

curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/countries'

Yanıt

Standart zarf olmadan eski biçimdeki gövde: {code: 200, data: [...]}. status nesnesi, msg veya results alanı bulunmaz. data, ülkeleri belirli bir sıralama garantisi olmadan listeler. Alanlar: countrycode ('+' olmadan ülke arama kodu), name, description (name ile aynı değere sahiptir), isocode, latitude ve longitude. is_mobile, sms_coverage veya next_function alanları bulunmaz. Bir ülke, görünür olduğunda ve özel numara kataloğuna bağlı olduğunda listelenir. Stok kontrolü yapılmadığından, listelenen bir ülkede şu anda kullanılabilir numara bulunmayabilir. Koşulları karşılayan hiçbir ülke yoksa data değeri null olur.

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

{
  "code": 200,
  "data": [
    {
      "countrycode": "33",
      "name": "France",
      "description": "France",
      "isocode": "FR",
      "latitude": "46.0000",
      "longitude": "2.0000"
    }
  ]
}

Hatalar

  • 401: Kimlik doğrulama eksik veya başarısız. Eski biçimdeki gövdede değil, standart status/response zarfında HTTP status 401 ile gönderilir.

Kullanılabilirlik ve yan etkiler

  • Yalnızca sorgulama yapar. Hiçbir şeyi rezerve etmez, sipariş etmez veya değiştirmez.