API DataPass

DataPass est un service de gestion des demandes d'habilitations pour accéder aux données restreintes et services de l'État.

Vocabulaire

Les concepts manipulés par DataPass sont les suivants:

• Utilisateur : Un utilisateur est un individu ayant un compte sur DataPass. Il peut être un demandeur ou un instructeur.
• Organisation : Une organisation est un groupe d'utilisateurs représentée par un SIRET. Elle peut être une entreprise ou un service de l'État.
• Demande d'habilitation : Les demandes d'habilitations représentent les données soumises via un formulaire par un demandeur. Une demande est liée à un type d'habilitation, un formulaire, une organisation et un utilisateur (le demandeur).
• Habilitation : Une habilitation est un droit d'accès délivré à une organisation suite à la validation d'une demande par un instructeur.
• Définition d'habilitation : Les demandes et les habilitations sont liées à une définition d'habilitation, qui définit les attributs de la demande.
• Formulaire : Un formulaire définit l'interface de saisie des données d'une demande d'habilitation, avec ses éventuels champs pré-remplis en fonction des cas d'usage.

Cycle de vie d'une demande

Consultez la documentation sur le cycle de vie d'une demande pour comprendre comment les différents états d'une demande et de ses habilitations sont gérés.

Pour le cas d'une habilitation avec étapes Bac à Sable et Production, consultez la documentation sur le cycle de vie d'une demande avec étapes pour comprendre comment la transition d'étape est gérée.

Authentification

Authentification via OAuth2:

1. Obtenir un jeton OAuth2 via le endpoint /oauth/token
2. Utiliser le jeton pour effectuer des requêtes à l'API

A noter qu'un client OAuth2 est associé à un utilisateur, et que les types de demandes d'habilitations accessibles sont régies par les droits associés à cet utilisateur. Pour qu'un utilisateur puisse manipuler à travers l'API les demandes d'habilitations d'un certain type, il doit être référencé comme étant développeur pour ce type d'habilitation dans DataPass. Pour cela, il faut qu'un administrateur l'ajoute manuellement.

Vous pouvez consulter les droits de développeurs que vous avez ainsi que votre client_id et client_secret sur votre profil