Jeton d'authentification
Comment fonctionne notre système d'authentification ?
Comment accéder aux jetons ?
Connectez-vous avec votre compte administrateur et cliquez sur Voir mon profil
Comment créer un jeton ?
Cliquez sur le bouton Créer et afficher un nouveau jeton.
Attention, le jeton n'est affiché qu'à la création !
Comment fonctionnent les jetons ?
Les jetons peuvent être configurés pour :
Accéder en lecture et/ou écriture à toutes les démarches de l'administrateur ayant généré le jeton
Accéder en lecture et/ou écriture uniquement à une liste fermée des démarches de l'administrateur ayant généré le jeton
Pour des raisons de sécurité, nous recommandons l'usage de ce type de jeton qui restreint l'accès aux démarches nécessaires.
Comment utiliser le jeton ?
Ce jeton doit être fourni dans l’en-tête HTTP Authorization
de la requête.
Authorization: Bearer token=valeur_du_jeton
.
GraphQL
POST
https://www.demarches-simplifiees.fr/api/v2/graphql
Le point d’entrée de l’API GraphQL.
Headers
Request Body
Exemple de requête
Pour tester que tout fonctionne bien
Pour tester l’API, le plus simple est d’effectuer une requête curl telle que ci dessous. Le principe est le même avec un autre client HTTP : remplacez votre_token et votre_numero_de_demarche par les valeurs souhaitez, et n’oubliez pas de préciser le content-type qui est toujours application/json
:
Vous devriez alors obtenir des informations en sortie. S’il y a des dossiers dans votre démarche, cette requête vous donne les noms des demandeurs. Si la démarche s’adresse à des entreprises, vous aurez le numéro SIRET des demandeurs.
Exemple si mon jeton est A9Knc34tP==
avec le numéro de démarche 12345
:
Voici la réponse de l'API pour cette requête :
Si vous obtenez une erreur, vérifiez que :
chaque paramètre
header
est correctil n'y a pas d'espace ou de guillemet en trop ou en moins
les majuscules et miniscules sont respectées
l'url, le jeton et le numéro de démarche sont corrects
lisez le message d'erreur et consultez nos pages Problèmes fréquents d'authentification et la gestion d'erreur
Dernière mise à jour