API¶
Introduction¶
Diag&Go - toolimo à mis en place une API REST utilisant le vocabulaire schema.org. Nous utilisons et exposons le format JSON-LD.
L’utilisation de l'API exige une connaissance de base des services Web.
URL de base de l'API :
| Environnement | URL |
|---|---|
| production | https://api.diagandgo.fr/ |
| sandbox | https://api.diagandgo.cloud/ |
Tous les appels de l'API commencent par cette URL à laquelle s'ajoute le chemin vers la ressource souhaitée.
L'API est accessible uniquement via le protocole HTTPS et accepte les verbes OPTIONS, GET, POST, PUT.
Les données envoyées en POST doivent respecter le format JSON.
Authentification¶
Nous utilisons deux types d'authentifications.
- JWT utilisée sur les ressources principales (process de commande)
- Authentification par jeton qui consiste à transmettre un token dans le header
X-AUTH-TOKEN, (webhook, ...)