Elencare i paesi del catalogo (formato precedente)

Questo endpoint del sistema precedente restituisce un corpo di risposta {"code", "data"} anziché la struttura standard status/response. Elenca i paesi visibili collegati al catalogo dei numeri speciali e non verifica la disponibilità dei numeri.

Per le nuove integrazioni:

• Utilizzare GET /v3/getcountries per trovare i paesi con numeri disponibili.
• Utilizzare GET /v3/other/{isocode} per vedere quali tipi di numeri speciali sono effettivamente offerti in un paese. Un paese elencato qui può comunque restituire un catalogo vuoto tramite quell'endpoint.

Richiesta

Obbligatorio: autenticazione HTTP Basic o token Bearer (vedere Autenticazione e risposte API). In caso di autenticazione non riuscita, viene restituita una risposta HTTP 401 nella struttura standard prima che venga eseguita la ricerca.

GET senza parametri e senza corpo della richiesta.

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

Risposta

Corpo di risposta nel formato precedente, senza la struttura standard: {code: 200, data: [...]}. Non sono presenti né l'oggetto status né i campi msg o results. data elenca i paesi senza un ordine garantito. Campi: countrycode (prefisso telefonico senza '+'), name, description (stesso valore di name), isocode, latitude e longitude. Non sono presenti i campi is_mobile, sms_coverage o next_function. Un paese viene elencato quando è visibile e collegato al catalogo dei numeri speciali. La disponibilità non viene verificata, quindi un paese elencato potrebbe attualmente non avere numeri disponibili. Se nessun paese soddisfa i criteri, data è null.

Struttura di risposta a scopo illustrativo; non si tratta di dati dell'account in tempo reale né di un preventivo attuale.

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

Errori

• 401: Autenticazione mancante o non riuscita. La risposta viene inviata con status HTTP 401 nella struttura standard status/response, non nel corpo di risposta del formato precedente.

Disponibilità ed effetti collaterali

• Solo consultazione. Non prenota, non ordina e non modifica nulla.