Passer au contenu principal
POST
cURL
Utilisez cet endpoint pour créer des questionnaires simples via l’API. Envoyez un tableau form_elements dans l’ordre dans lequel les utilisateurs doivent répondre aux questions. Didit construit pour vous le graphe interne du questionnaire. L’API prend en charge uniquement les questionnaires linéaires simples. N’envoyez pas graph, branches, next ni de règles conditionnelles.

Champs obligatoires

  • title correspond au nom interne du questionnaire.
  • languages doit inclure en.
  • form_elements doit contenir au moins une question.
  • Chaque élément de formulaire nécessite un element_type et un label traduit.
Vous pouvez également ajouter à un élément de formulaire une description traduite facultative, qui sert de texte d’aide. Elle est acceptée pour tous les types d’éléments, à l’exception de separator, et elle est renvoyée comme description de l’élément dans le rapport du questionnaire.

Types d’éléments

Utilisez des valeurs en minuscules, comme short_text, multiple_choice, email, file_upload ou date_picker. Les valeurs d’énumération en majuscules, comme SHORT_TEXT, sont également acceptées. Pour dropdown, single_choice et multiple_choice, ajoutez options. Si vous omettez la value d’une option, Didit en génère une à partir du libellé.

Validation des champs

Ajoutez un objet validation facultatif à un élément short_text, long_text ou number pour imposer un format à la réponse de l’utilisateur. Cela est utile pour les identifiants au format strict, comme les identifiants fiscaux, les numéros d’identité nationale ou les numéros de carte. La validation s’exécute pendant que l’utilisateur remplit le champ (il ne peut pas passer à l’étape suivante tant que la valeur n’est pas valide) et l’API la réapplique lors de la soumission.
La réponse contient questionnaire_id. Conservez-le, car vous l’utiliserez comme questionnaire_uuid lorsque vous ajouterez le questionnaire à un workflow.

Autorisations

x-api-key
string
header
requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Corps

application/json

Créez un questionnaire linéaire simple. L'API convertit form_elements en graphe interne du questionnaire.

title
string
requis

Nom interne du questionnaire.

languages
string[]
requis

Langues incluses dans chaque libellé. Doit inclure en.

Exemple:
form_elements
object[]
requis

Questions dans l'ordre exact où les utilisateurs doivent les voir. Les embranchements et les champs conditionnels ne sont pas pris en charge.

Minimum array length: 1
description
string | null
default_language
string

Langue par défaut. Doit être incluse dans languages.

Exemple:

"en"

is_active
boolean
défaut:true
status
enum<string>

Omettez ce champ pour créer un questionnaire publié et prêt pour les workflows.

Options disponibles:
draft,
published

Réponse

Questionnaire créé. La réponse inclut le questionnaire_id — conservez-le pour référencer ce questionnaire dans les workflows ou lors de futurs appels de mise à jour/suppression.

Détails complets du questionnaire renvoyés par les endpoints GET, POST (création) et PATCH (mise à jour).

questionnaire_id
string<uuid>

Identifiant unique du questionnaire. Utilisez cet identifiant pour faire référence au questionnaire depuis un workflow ou lors de requêtes ultérieures de mise à jour ou de suppression.

title
string
description
string | null
languages
string[]
default_language
string
is_active
boolean
is_simple_questionnaire
boolean
graph
object

Structure en graphe avec start_node et la table de correspondance des nœuds.

sections
object[]

Contenu du questionnaire regroupé en sections (dérivé du graphe).

questionnaire_group_id
string<uuid>

Identifiant stable qui regroupe toutes les versions du même questionnaire.

version
integer
status
enum<string>
Options disponibles:
draft,
published
published_at
string<date-time> | null
is_editable
boolean

Vrai lorsque le questionnaire peut encore être modifié directement (versions brouillon).

Dernière modification le 7 novembre 2026