Référentiels

Lister les pays

GET /v1/countries
vpn_key Toute clé valide Compte comme une lecture

Renvoie la liste des pays connus de Wanapos, par ordre alphabétique. Elle est la même pour tous les comptes. Toute clé valide peut l'appeler.

pays_code est la valeur à donner dans adresse.pays_code pour créer ou modifier un client. La liste compte environ deux cents lignes et est renvoyée en une seule fois, sans paramètre : inutile de la relire à chaque appel.

Exemple d'appel

curl "https://api.wanapos.com/v1/countries" \
  -H "Authorization: Bearer VOTRE_CLE"

Réponse en cas de succès (statut 200)

Les pays.

Champ Type Description
data liste Pays, par ordre alphabétique.
data[].id_pays entier Identifiant du pays.
data[].pays_code texte Code du pays à deux lettres. C'est la valeur à donner dans adresse.pays_code pour créer ou modifier un client.
data[].pays texte Nom du pays en français.
meta objet
meta.request_id texte Identifiant de l'appel.
meta.count entier Nombre d'éléments renvoyés.
{
    "data": [
        {
            "id_pays": 20,
            "pays_code": "BE",
            "pays": "Belgique"
        },
        {
            "id_pays": 63,
            "pays_code": "FR",
            "pays": "France"
        }
    ],
    "meta": {
        "request_id": "3f9a1c0b7d2e4a61",
        "count": 2
    }
}

Erreurs possibles

  • 401 Clé absente, inconnue ou révoquée. Codes : missing_key, invalid_key.
  • 403 Appel refusé pour ce compte ou cette clé. Codes : api_not_activated, account_not_eligible, access_blocked, missing_scope.
  • 422 Un paramètre est absent, inconnu ou invalide. Code : invalid_parameter. Le champ field nomme le paramètre.
  • 429 Quota dépassé. Codes : rate_limited, daily_quota_exceeded, too_many_failed_attempts. L'en-tête Retry-After indique combien de secondes attendre.

Voir toutes les erreurs

Une question ? contact@wanapos.com