Authentification

Pour accéder à l’API Visamundi, vous devez posséder une clé API qui permet d’authentifier les demandes de requêtes à celle-ci.

Depuis février 2025, la nouvelle version de l’API est la v3. Cela change uniquement l’URL de base ainsi que la manière de s’authentifier. Le contenu des réponses générées par l’API est le même entre la v2 et la v3.

L’URL de l’API Visamundi passe de https://api.visamundi.io/v2/ à https://connect.visamundi.io/v3/. De plus, le paramètre GET recevant votre clé API n’est plus le même, il passe de apikey à access_token.

Deux manières d’authentifier les demandes de requêtes sont possibles :

Paramètre GET

Vous pouvez transmettre votre clé API avec chaque requête en ajoutant apikey (v2) ou access_token (v3) en tant que paramètre GET à votre requête.

AVERTISSEMENT
Cette méthode pourrait exposer votre clé API dans des journaux d’accès et autres. L’envoi de la clé API via l’en-tête HTTP comme spécifié ci-dessous contourne ce problème.

v3

Exemple de requête avec authentification via le paramètre GET :

GET  https://connect.visamundi.io/v3/ENDPOINT?access_token=VOTRE-CLE-API

v2

Exemple de requête avec authentification via le paramètre GET :

GET  https://api.visamundi.io/v2/ENDPOINT?apikey=VOTRE-CLE-API

En-tête HTTP

v3

Exemple de requête avec authentification via l’en-tête HTTP :

curl "https://connect.visamundi.io/v3/ENDPOINT" -H "Authorization: Bearer VOTRE-CLE-API"

v2

Exemple de requête avec authentification via l’en-tête HTTP :

curl "https://api.visamundi.io/v2/ENDPOINT" -H "apikey: VOTRE-CLE-API"