MultiTEL
Dezvoltatori

GET/v3/countries

Listarea țărilor din catalog (format vechi)

Endpoint vechi care returnează țările vizibile asociate catalogului de numere speciale utilizat de GET /v3/other/{isocode}, într-un corp de răspuns de forma {code, data}. Nu verifică stocul. Utilizați GET /v3/getcountries pentru a găsi țările cu numere în stoc.

Pe această pagină
  1. Cerere
  2. Răspuns
  3. Erori
  4. Disponibilitate și efecte secundare

Acest endpoint vechi returnează un corp de răspuns de forma {"code", "data"} în locul structurii standard status/response a răspunsului. Listează țările vizibile asociate catalogului de numere speciale și nu verifică stocul.

Pentru integrările noi:

  • Utilizați GET /v3/getcountries pentru a găsi țările cu numere în stoc.
  • Utilizați GET /v3/other/{isocode} pentru a vedea ce tipuri de numere speciale sunt oferite efectiv într-o țară. Chiar dacă o țară este listată aici, interogarea respectivă poate returna un catalog gol pentru acea țară.

Cerere

Obligatoriu: autentificare HTTP Basic sau token Bearer (consultați Autentificare și răspunsuri API). Dacă autentificarea eșuează, se returnează HTTP 401 în structura standard a răspunsului, înainte de executarea interogării.

GET fără parametri și fără corp de cerere.

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

Răspuns

Corp de răspuns în format vechi, fără structura standard: {code: 200, data: [...]}. Nu există obiectul status și nici câmpurile msg sau results. data listează țările fără a garanta o anumită ordine. Câmpuri: countrycode (prefix telefonic fără '+'), name, description (aceeași valoare ca name), isocode, latitude și longitude. Nu există câmpurile is_mobile, sms_coverage sau next_function. O țară este listată dacă este vizibilă și asociată catalogului de numere speciale. Stocul nu este verificat, așadar o țară listată poate să nu aibă niciun număr disponibil în prezent. Dacă nicio țară nu îndeplinește condițiile, data este null.

Exemplu ilustrativ al structurii răspunsului; nu reprezintă date în timp real ale contului sau o ofertă de preț actuală.

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

Erori

  • 401: Autentificarea lipsește sau a eșuat. Se trimite cu status HTTP 401 în structura standard status/response a răspunsului, nu în corpul de răspuns în format vechi.

Disponibilitate și efecte secundare

  • Doar interogare. Nu rezervă, nu comandă și nu modifică nimic.