Documentation de demarches-simplifiees.fr
  • Généralités
  • Présentation
  • Cible
  • Démarrage
  • Cas d'usage
  • Tutoriels et vidéos
    • Tutoriel usager
    • Tutoriel « expert invité »
    • Tutoriel instructeur
    • Tutoriel administrateur
    • Les bonnes pratiques lors de la création d'une démarche
    • Vidéo : la sécurité de demarches-simplifiees.fr
    • Vidéo : le cadre juridique
    • Vidéo : la relation usager
    • Intégration du bouton « Mon avis »
  • Nouveautés
    • Pour les administrateurs
    • Pour les instructeurs
    • Pour les usagers
  • Expérimentations
    • Type de champ expression régulière
    • Chorus
  • Nos démarches
    • Démarches modèles à dupliquer
    • Démarches relatives au permis de conduire
    • Démarches relatives aux transporteurs
    • Démarches relatives au secteur du transport public de tourisme (T3P) - Taxis et VTC
    • Démarches relatives aux étrangers résidant en France
    • Démarches relatives aux inscriptions scolaires (inscription, restauration, centres de loisirs)
    • Démarches relatives aux médailles d'honneur
    • Démarches relatives aux Tribunal judiciaire de Lille
  • Conditions Générales d'Utilisation
  • Conditions générales d'utilisation : usagers
  • Politique de confidentialité
  • Mentions légales
  • API GraphQL
    • Automatisation : obligations des utilisateurs publics
    • Introduction technique
    • Accréditation
    • Le playground / Premiers pas
    • Point d'entrée et Schema GraphQL
    • Jeton d'authentification
      • Problèmes fréquents
    • Les queries
      • getDemarche
      • getDossier
      • getGroupeInstructeur
      • getDemarcheDescriptor
    • Les mutations
      • Modifier l'état d'un dossier
      • Envoyer un message
      • Ajouter ou supprimer un label
    • Pagination
    • Gestion des Erreurs
    • Cas d'usages / exemple d'implémentation
      • Client de démo en JS
      • Autentification
      • Récupérer un dossier
      • Pagination – Synchroniser une démarche à faible volumétrie (polling simple)
      • Pagination – Récupérer tous les dossiers d'une démarche
      • Pagination – Synchroniser une démarche à forte volumétrie (synchronisation)
      • Télécharger les fichiers uploadés par un usager sur son dossier
      • Envoyer un message avec une PJ
      • Accepter un dossier et y joindre un justificatif (une PJ)
      • Lister les Id des instructeurs
  • Pour aller plus loin
    • Cartographie
    • API de préremplissage
    • Aspects techniques et juridiques
    • Exports de données
    • Exports et Macros
    • Routage des dossiers
    • Webinaires
    • Horodatage
    • Archivage longue durée des démarches
    • Le conditionnel
    • Eligibilité des dossiers
    • Export personnalisé
  • Communiqués de presse
  • Expiration et suppression des dossiers
Propulsé par GitBook
Sur cette page
  • Présentation
  • Clés et valeurs
  • Préremplissage en GET (par URL)
  • Préremplissage en POST
  • Requête
  • Réponse
  • Environnement
  • Démarrage rapide
  • Structure de la démarche
  • Requête
  • Réponse
  • Statistiques sur le traitement des dossiers
Exporter en PDF
  1. Pour aller plus loin

API de préremplissage

Grâce à l'API de préremplissage, il est possible de préremplir un dossier pour une démarche donnée.

PrécédentCartographieSuivantAspects techniques et juridiques

Dernière mise à jour il y a 1 an

Vous disposez de données sur vos usager·ères et vous souhaitez les utiliser pour préremplir un dossier ?

Présentation

demarches-simplifiees.fr propose une API de préremplissage. Pour une démarche donnée, elle permet de préremplir un dossier, avec les données dont vous disposez déjà.

Pour accéder à cette fonctionnalité, la démarche doit :

  • être soit en brouillon, soit publiée (donc la fonctionnalité n'est pas disponible pour les démarches closes)

  • être en opendata (configurable depuis la tuile "Présentation")

Le dossier est créé en brouillon et vous pouvez y diriger votre usager·ère afin qu'iel s'authentifie, poursuive son remplissage, et le dépose auprès de l'administration.

Cette API est REST et ne nécessite pas d'authentification.

Clés et valeurs

Le principe du préremplissage d'un dossier est le suivant : vous fournissez à l'API un couple clé / valeur pour chaque champ de la démarche à préremplir.

La clé est un identifiant en base 64. Elle identifie le champ de façon unique. Elle est stable et ne change pas dans le temps. Elle ressemble à une chaîne de cette forme : "champ_Q2hhbXAtMTx0MjM2OX==".

La valeur est la donnée à renseigner dans le champ du formulaire. Selon le type de champ, cette valeur peut être contrainte. Par exemple, il est impossible de fournir la valeur "toto" pour un champ de type entier.

Préremplissage en GET (par URL)

L'API de préremplissage met à votre disposition une URL, que vous pouvez communiquer à votre usager·ère. Cette URL crée un dossier prérempli en brouillon. Elle permet à l'usager·ère de s'authentifier, puis d'accéder au dossier afin de poursuivre son remplissage et enfin de le déposer.

L'URL prend la forme suivante :

https://www.demarches-simplifiees.fr/commencer/<nom-demarche>?<cle1>=<valeur1>&<cle2>=<valeur2>

Préremplissage en POST

L'API de préremplissage permet la création d'un dossier prérempli avec un appel en POST. Cette approche n'impose pas de limite sur la quantité ou la longueur des champs à préremplir.

Requête

La requête doit être adressé en POST à l'URL /api/public/v1/demarches/<id-demarche>/dossiers. Elle prend donc en paramètre de route l'ID de la démarche.

Il est ensuite nécessaire d'indiquer :

  • le content type application/json dans les headers de la requête

  • la liste de couples clé / valeur, au format JSON, dans le body de la requête

Une requête complète prend donc la forme suivante :

curl --request POST 'https://demarches-simplifiees.fr/api/public/v1/demarches/<id>/dossiers' \
     --header 'Content-Type: application/json' \
     --data '{"cle1": "valeur1", "cle2": "valeur2"}'

Réponse

L'API répond en JSON. La réponse contient l'URL du dossier vers laquelle diriger l'usager·ère. Iel peut alors s'authentifier, poursuivre le remplissage et déposer le dossier auprès de l'administration.

La réponse prend la forme suivante :

{
  "dossier_url": "https://demarches-simplifiees.fr/commencer/<nom-demarche>?prefill_token=<token de préremplissage>",
  "dossier_id": "<ID du dossier en base 64>",
  "dossier_number": <ID du dossier en tant qu'entier>
}

Au moment de la réponse, le dossier est orphelin. Il est rattaché à l'usager·ère après son authentification.

Environnement

demarches-simplifiees.fr ne propose pas d'environnement de test, intégration, préproduction ou sandbox, sur lequel réaliser votre intégration.

À la place, vous pouvez travailler sans risque directement sur la production (https://demarches-simplifiees.fr). En effet, au cours de l'intégration, vous allez créer des dossiers en brouillon, et ceux-ci :

  • sont supprimés périodiquement,

  • ne sont pas soumis à l'administration tant qu'ils ne sont pas récupérés, complétés et déposés par un·e usager·ère,

  • sont invisibles pour l'administration concernée tant qu'ils ne sont pas soumis.

Démarrage rapide

Vous connaissez le nom de la démarche ? Alors rendez-vous directement sur la page /preremplir/<nom-demarche>.

Par exemple, si votre démarche est une-demarche-a-preremplir, alors ouvrez la page :

Vous y trouverez :

  • les champs de la démarche, avec leur ID, leur type, leur description et les valeurs possibles pour le préremplissage

Structure de la démarche

Requête

Un point de terminaison vous donnant accès à une description en JSON du schéma de la démarche est à votre disposition. La requête doit être adressée en GET à l'URLl /preremplir/<nom-demarche>/schema.

Par exemple, si votre démarche est une-demarche-a-preremplir, la requête doit être adressée à :

L'API répond en JSON. La réponse contient des informations génériques sur la démarche ainsi que l’identifiant stable, le titre, la description de chaque champ de la démarche. Elle indique aussi les champs requis ou non.

Réponse

La réponse prend la forme suivante :

{
  "id": "ID_démarche",
  "number": "Numéro_démarche",
  "title": "Titre_démarche",
  "description": "Description_démarche",
  "state": "publiee",
  "declarative": null,
  "dateCreation": "2023-01-16T11:10:48+01:00",
  "datePublication": "2023-01-16T11:18:32+01:00",
  "dateDerniereModification": "2023-01-16T16:55:21+01:00",
  "dateDepublication": null,
  "dateFermeture": null,
  "notice": null,
  "deliberation": null,
  "cadreJuridiqueUrl": "http://cadredemarche.fr/cadre",
  "revision": {
    "id": "ID_Revision",
    "datePublication": "2023-01-16T16:55:21+01:00",
    "champDescriptors": [
      {
        "__typename": "TextChampDescriptor",
        "id": "Stable_ID_Démarche1",
        "label": "Titre_Démarche1",
        "description": "Description_Démarche1",
        "required": true
      },
      {
        "__typename": "TextareaChampDescriptor",
        "id": "Stable_ID_Démarche2",
        "label": "Titre_Démarche2",
        "description": "Description_Démarche2",
        "required": false
      }
    ]
  }
}

Statistiques sur le traitement des dossiers

Pour une démarche donnée, vous pouvez obtenir des statistiques sur le traitement des dossiers, de deux manières différentes :

  • en HTML, en vous rendant avec un navigateur sur la page /statistiques/<nom-demarche>

  • en JSON, en envoyant une requête en GET à l'URL /api/public/v1/demarches/<id-demarche>/stats

Comme il s'agit d'une URL, celle-ci est limitée en longueur (à 2000 caractères environ, selon les navigateurs). Le préremplissage par URL convient donc uniquement si vous avez peu de champs à préremplir, et / ou qu'il s'agit de champs dont la valeur est courte. Dans le cas contraire, il est préférable d'effectuer un .

Si vous le souhaitez, vous pouvez également prendre possession de ces dossiers en vous authentifiant, comme le ferait l'usager·ère, afin de les supprimer manuellement depuis la page .

l'URL pour le

un exemple de requête et de réponse pour le

https://www.demarches-simplifiees.fr/dossiers
https://www.demarches-simplifiees.fr/preremplir/une-demarche-a-preremplir
https://www.demarches-simplifiees.fr/preremplir/une-demarche-a-preremplir/schema
préremplissage en POST
préremplissage en GET
préremplissage en POST
Présentation de l'API de préremplissage