Phase d'authentification

Chaque appel requiert une authentification basée sur la méthode HTTP Basic Authentication.

Cette méthode utilise l'entête HTTP Authorization composé du mot Basic suivi par une chaine encodée en base64 contenant un nom d'utilisateur et un mot de passe séparés par deux-points (:).

• Le nom d'utilisateur est l'identifiant de la boutique : par exemple 28478261
• Le mot de passe est défini dans le Back Office Marchand : par exemple testpassword_HDBz5YpANEajG4DwYSmkQDNM9lzGiuvrhY9f6G9HEm5do.

Le nom d'utilisateur et le mot de passe sont disponibles dans le Back Office Marchand, menu Paramétrage > Boutique, onglet Clés d’API REST.

Comment construire le header HTTP "Authorization"

1. Créez une chaine de la forme nom d'utilisateur:mot de passe

   42229744:testpassword_IvhGC31Fb7m48mNmgdmRSGa5RkGy5nc0FXcvR1uKog8Ms

2. Encodez la chaine obtenue en base64

   Njk4NzYzNTc6dGVzdHBhc3N3b3JkX0RFTU9QUklWQVRFS0VZMjNHNDQ3NXpYWlEyVUE1eDdN

3. Ajoutez à votre requête le header "Authorization" contenant "Basic" suivi de la chaine encodée en base64:

   Authorization: Basic Njk4NzYzNTc6dGVzdHBhc3N3b3JkX0RFTU9QUklWQVRFS0VZMjNHNDQ3NXpYWlEyVUE1eDdN

En PHP, le header Authorization sera calculé de la façon suivante:

$header = "Authorization: Basic " . base64_encode($username . ':' . $password);

La requête HTTP complète ressemblera à :

{
    "value": "my testing value"
}

Quelques liens utiles

Pour plus de détails sur l’implémentation dans différents langages, vous pouvez consulter les gists Gitub suivants..