Lister les pays du catalogue (ancien format)

Cet ancien point de terminaison renvoie un corps au format {"code", "data"} au lieu de l’enveloppe standard status/response. Il répertorie les pays visibles associés au catalogue de numéros spéciaux et ne vérifie pas le stock.

Pour les nouvelles intégrations :

Utilisez GET /v3/getcountries pour trouver les pays où des numéros sont en stock.
Utilisez GET /v3/other/{isocode} pour connaître les types de numéros spéciaux effectivement proposés dans un pays. Un pays répertorié ici peut néanmoins y renvoyer un catalogue vide.

Requête

Obligatoire : authentification HTTP Basic ou jeton Bearer (voir Authentification et réponses de l’API). En cas d’échec de l’authentification, une réponse HTTP 401 est renvoyée dans l’enveloppe standard avant l’exécution de la recherche.

GET sans paramètres et sans corps.

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

Réponse

Corps à l’ancien format, sans l’enveloppe standard : {code: 200, data: [...]}. Il ne contient ni objet status, ni champ msg ou results. data répertorie les pays sans ordre garanti. Champs : countrycode (indicatif téléphonique sans '+'), name, description (même valeur que name), isocode, latitude et longitude. Les champs is_mobile, sms_coverage et next_function sont absents. Un pays est répertorié lorsqu’il est visible et associé au catalogue de numéros spéciaux. Le stock n’est pas vérifié ; un pays répertorié peut donc n’avoir actuellement aucun numéro disponible. Si aucun pays ne remplit les critères, data vaut null.

Structure de réponse fournie à titre d’exemple ; il ne s’agit ni de données de compte en temps réel ni d’un devis actuel.

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

Erreurs

401: Authentification absente ou échouée. Réponse envoyée avec HTTP status 401 dans l’enveloppe standard status/response, et non dans le corps à l’ancien format.

Disponibilité et effets de bord

Consultation uniquement. Ce point de terminaison ne réserve rien, ne passe aucune commande et ne modifie rien.