Envoyer votre première requête

Une fois vos identifiants créés dans le dashboard Chargetrip, vous pouvez commencer à effectuer des requêtes autorisées à l’aide de nos URL de base et des en-têtes d’authentification requis.

La configuration

L’API Chargetrip utilise deux points de terminaison distincts selon le type d’opération : une URL HTTPS pour les requêtes et les mutations, et une URL WebSocket (WSS) pour les abonnements. Vous trouverez plus d’informations sur l’API dans la référence de l’API GraphQL.

Requêtes et mutations

Les requêtes et les mutations sont exécutées via des requêtes HTTP POST vers le point de terminaison GraphQL principal.

https://api.chargetrip.io/graphql

Abonnements

Les abonnements nécessitent une connexion persistante via WebSockets et peuvent être implémentés à l’aide du protocole graphql-transport-ws. Pour en savoir plus sur l’utilisation des websockets, consultez cette page.

wss://api.chargetrip.io/subscription

En-têtes d’autorisation

Après avoir obtenu l’URL de base, ajoutez les en-têtes suivants à chaque requête. Les en-têtes marqués comme requis doivent toujours être envoyés.

x-client-id · requis

Un identifiant de projet qui contient la configuration du projet.

x-app-id · requis

Un identifiant d’application pour la sécurité et la séparation des analyses.

x-app-identifier

Un identifiant de bundle iOS ou Android.

x-app-fingerprint

Une empreinte SHA Android.

Envoyer une requête autorisée

Pour communiquer avec l’API, vous devez authentifier chaque requête avec les en-têtes x-client-id et x-app-id. Par défaut, un x-app-id unique est généré pour chaque projet.

curl -X POST \  -H "Content-Type: application/json" \  -H "x-client-id: YOUR_KEY_HERE" \  -H "x-app-id: YOUR_KEY_HERE" \  -d '{ "query": "{ } " }' \  https://api.chargetrip.io/graphql