Aller au contenu principal

Authentification

Tous les appels à l'API publique doivent se faire de manière authentifiée. Voici les étapes pour pouvoir faire votre premier appel à l'API.

Création d'un compte développeur​

Pour créer un compte développeur :

  1. Rendez-vous sur la page d'inscription correspondant à votre environnement :

https://www.cocolis.fr/pro-sender-sign-up

Obtenir son token d'authentification​

Rendez vous sur la page de gestion de votre clé api, puis créer ou regénérer votre clé api.

Gardez précieusement le token généré. C'est votre mot de passe API, toute personne ayant accès à ce token pourra se faire passer pour vous via des appels API.

Ce token ne sera plus accessible plus tard, le seul moyen sera d'en regénérer un nouveau.

Appels authentifiés​

Lors de tous vos appels API, vous devrez passer en header l'information suivante

{
  "method": "get",
  "url": "https://api.cocolis.fr/api/v1/rides/mine",
  "headers": {
    "X-API-KEY": "VOTRE_TOKEN"
  }
}

Si votre token n'est pas valide ou votre méthode d'authentification n'est pas la bonne, vous aurez une erreur 401.