Vai al contenuto principale
POST
cURL
Usa questo endpoint per creare questionari semplici tramite API. Invia un array form_elements nell’ordine in cui gli utenti devono rispondere alle domande. Didit costruisce per te il grafo interno del questionario. L’API supporta solo questionari lineari semplici. Non inviare graph, branches, next né regole condizionali.

Campi obbligatori

  • title è il nome interno del questionario.
  • languages deve includere en.
  • form_elements deve contenere almeno una domanda.
  • Ogni elemento del modulo richiede un element_type e una label tradotta.
Puoi anche aggiungere a un elemento del modulo una description tradotta facoltativa, come testo di aiuto. È accettata per tutti i tipi di elemento tranne separator e viene restituita come description dell’elemento nel report del questionario.

Tipi di elemento

Usa valori in minuscolo come short_text, multiple_choice, email, file_upload o date_picker. Sono accettati anche i valori enum in maiuscolo, come SHORT_TEXT. Per dropdown, single_choice e multiple_choice, aggiungi options. Se ometti il value di un’opzione, Didit lo genera a partire dall’etichetta.

Validazione dei campi

Aggiungi un oggetto validation facoltativo a un elemento short_text, long_text o number per imporre un formato alla risposta dell’utente. È utile per identificativi con formati rigidi, come codici fiscali, documenti d’identità nazionali o numeri di carta. La validazione viene eseguita mentre l’utente compila il campo (l’utente non può proseguire finché il valore non è valido) e viene applicata di nuovo dall’API all’invio.
La risposta include questionnaire_id. Conservalo, perché lo userai come questionnaire_uuid quando aggiungi il questionario a un workflow.

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Corpo

application/json

Crea un questionario lineare semplice. L'API converte form_elements nel grafo interno del questionario.

title
string
obbligatorio

Nome interno del questionario.

languages
string[]
obbligatorio

Lingue incluse in ogni etichetta. Deve includere en.

Esempio:
form_elements
object[]
obbligatorio

Domande nell'ordine esatto in cui gli utenti dovrebbero vederle. La ramificazione e i campi condizionali non sono supportati.

Minimum array length: 1
description
string | null
default_language
string

Lingua predefinita. Deve essere inclusa in languages.

Esempio:

"en"

is_active
boolean
predefinito:true
status
enum<string>

Ometti questo campo per creare un questionario pubblicato pronto per i workflow.

Opzioni disponibili:
draft,
published

Risposta

Questionario creato. La risposta include il questionnaire_id — memorizzalo per fare riferimento a questo questionario dai workflow o dalle future chiamate di aggiornamento/eliminazione.

Dettaglio completo del questionario restituito dagli endpoint GET, POST (creazione) e PATCH (aggiornamento).

questionnaire_id
string<uuid>

Identificativo univoco del questionario. Usa questo id quando fai riferimento al questionario da un workflow o nelle successive richieste di aggiornamento/eliminazione.

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

Struttura a grafo con start_node e mappa dei nodi.

sections
object[]

Contenuto del questionario raggruppato in sezioni (derivato dal grafo).

questionnaire_group_id
string<uuid>

Identificatore stabile che raggruppa tutte le versioni dello stesso questionario.

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

True quando il questionario può ancora essere modificato direttamente (versioni in bozza).

Ultima modifica il 7 novembre 2026