Listează țările cu numere în stoc

Începeți aici căutarea numerelor locale. Lista conține doar țările care au în prezent numere în stoc. Această operațiune nu rezervă nimic.

• Transmiteți isocode către getareas, către getstates (doar pentru US și CA) sau către other.
• next_function indică întotdeauna v3/getareas/{isocode}. Pentru Statele Unite și Canada, puteți apela getstates mai întâi, pentru a restrânge căutarea după stat sau provincie.
• is_mobile și sms_coverage sunt indicatori la nivel de țară, nu garanții pentru fiecare număr. Pentru Statele Unite, is_mobile este 0 cu excepția cazului în care contul dumneavoastră este activat pentru numere mobile din SUA.
• Țările a căror acoperire constă exclusiv în numere disponibile numai la comandă nu sunt incluse în listă. Puteți totuși apela getareas sau other direct pentru o țară care nu este inclusă în listă.
• Sortați lista dumneavoastră dacă aveți nevoie de o anumită ordine.

Dacă nicio țară nu îndeplinește condițiile, response este null și status.code este 200.

Cerere

Obligatoriu: autentificare HTTP Basic sau un token Bearer (consultați Autentificare și răspunsuri API). Dacă autentificarea eșuează, se returnează HTTP 401 înainte de efectuarea căutării.

GET fără corp de cerere. Singurul parametru este pid, opțional, transmis în șirul de interogare.

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

Răspuns

Structură standard de încadrare a răspunsului. În caz de succes, status.code este 200, status.msg este 'Results: N', status.results este N, iar response este o listă de țări fără o ordine garantată. Câmpuri: countrycode (prefixul telefonic internațional al țării, fără '+'); name (numele țării); description (aceeași valoare ca name); isocode (codul ISO 3166-1 alpha-2); is_mobile (0 sau 1, un indicator de catalog la nivel de țară, întotdeauna 0 pentru US, cu excepția cazului în care contul dumneavoastră este activat pentru numere mobile din US); sms_coverage (0 sau 1, un indicator de catalog la nivel de țară); latitude și longitude (coordonatele țării); next_function ('v3/getareas/{isocode}'). O țară este inclusă în listă doar dacă este vizibilă și cel puțin unul dintre prefixele sale are în prezent numere în stoc în cel puțin o sursă de inventar. Țările a căror acoperire constă integral în numere disponibile numai la comandă (fără stoc) nu sunt incluse în listă. Această verificare a stocului are o sferă mai largă decât filtrele aplicate de getareas, astfel încât o țară inclusă în listă poate uneori să returneze acolo 'No areas found'. Dacă nicio țară nu îndeplinește condițiile, status.code este 200, status.msg este 'Results: 0', câmpul status.results lipsește, iar response este null.

Structură de răspuns prezentată cu titlu ilustrativ; nu reprezintă date în timp real ale contului sau o ofertă de preț actuală.

{
  "status": {
    "code": 200,
    "msg": "Results: 2",
    "results": 2
  },
  "response": [
    {
      "countrycode": "1",
      "name": "United States",
      "description": "United States",
      "isocode": "US",
      "is_mobile": 0,
      "sms_coverage": 1,
      "latitude": "38.0000",
      "longitude": "-97.0000",
      "next_function": "v3/getareas/US"
    },
    {
      "countrycode": "44",
      "name": "United Kingdom",
      "description": "United Kingdom",
      "isocode": "GB",
      "is_mobile": 1,
      "sms_coverage": 0,
      "latitude": "54.0000",
      "longitude": "-2.0000",
      "next_function": "v3/getareas/GB"
    }
  ]
}

Erori

• 401: Autentificarea lipsește sau a eșuat. Se transmite cu codul de stare HTTP 401 (consultați Autentificare și răspunsuri API).

Disponibilitate și efecte secundare

• Doar căutare. Nu rezervă, nu comandă și nu modifică nimic.
• Rezultatele reflectă stocul din momentul cererii și se pot modifica între apeluri.