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.

Un administrateur Cocolis doit vous créer une "API application", qui vous sera associée.

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.