Langsung ke konten utama
POST
cURL
Gunakan endpoint ini untuk membuat kuesioner sederhana melalui API. Kirim array form_elements sesuai urutan pertanyaan yang harus dijawab pengguna. Didit membangun graf kuesioner internal untuk Anda. API hanya mendukung kuesioner linear sederhana. Jangan kirim graph, branches, next, atau aturan kondisional.

Kolom wajib

  • title adalah nama internal kuesioner.
  • languages harus menyertakan en.
  • form_elements harus berisi minimal satu pertanyaan.
  • Setiap elemen formulir memerlukan element_type dan label yang sudah diterjemahkan.
Anda juga dapat menambahkan description opsional yang sudah diterjemahkan ke elemen formulir sebagai teks bantuan. Kolom ini diterima pada setiap jenis elemen kecuali separator, dan dikembalikan sebagai description item pada laporan kuesioner.

Jenis elemen

Gunakan nilai huruf kecil seperti short_text, multiple_choice, email, file_upload, atau date_picker. Nilai enum huruf besar seperti SHORT_TEXT juga diterima. Untuk dropdown, single_choice, dan multiple_choice, tambahkan options. Jika Anda menghilangkan value pada opsi, Didit akan membuatnya dari label.

Validasi kolom

Tambahkan objek validation opsional ke elemen short_text, long_text, atau number untuk menerapkan format pada jawaban pengguna. Ini berguna untuk pengenal dengan format ketat, seperti ID pajak, ID nasional, atau nomor kartu. Validasi dijalankan saat pengguna mengisi kolom (pengguna tidak dapat melanjutkan sebelum validasi lolos) dan API menerapkannya kembali saat jawaban dikirimkan.
Respons menyertakan questionnaire_id. Simpan nilai tersebut, karena Anda akan menggunakannya sebagai questionnaire_uuid saat menambahkan kuesioner ke sebuah alur kerja.

Otorisasi

x-api-key
string
header
wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.

Body

application/json

Buat kuesioner linier sederhana. API mengonversi form_elements menjadi graf kuesioner internal.

title
string
wajib

Nama internal untuk kuesioner.

languages
string[]
wajib

Bahasa yang disertakan dalam setiap label. Harus menyertakan en.

Contoh:
form_elements
object[]
wajib

Pertanyaan dalam urutan tepat seperti yang harus dilihat pengguna. Percabangan dan kolom kondisional tidak didukung.

Minimum array length: 1
description
string | null
default_language
string

Bahasa default. Harus disertakan dalam languages.

Contoh:

"en"

is_active
boolean
default:true
status
enum<string>

Kosongkan kolom ini untuk membuat kuesioner yang dipublikasikan dan siap digunakan untuk alur kerja.

Opsi yang tersedia:
draft,
published

Respons

Kuesioner dibuat. Respons menyertakan questionnaire_id — simpan untuk mereferensikan kuesioner ini dari alur kerja atau panggilan pembaruan/penghapusan mendatang.

Detail kuesioner lengkap yang dikembalikan dari endpoint GET, POST (buat), dan PATCH (perbarui).

questionnaire_id
string<uuid>

Pengenal unik kuesioner. Gunakan id ini saat mereferensikan kuesioner dari alur kerja atau dalam permintaan pembaruan/penghapusan berikutnya.

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

Struktur graf dengan start_node dan peta node.

sections
object[]

Konten kuesioner yang dikelompokkan ke dalam bagian-bagian (berasal dari graf).

questionnaire_group_id
string<uuid>

Pengidentifikasi stabil yang mengelompokkan semua versi dari kuesioner yang sama.

version
integer
status
enum<string>
Opsi yang tersedia:
draft,
published
published_at
string<date-time> | null
is_editable
boolean

True saat kuesioner masih dapat diedit langsung di tempat (versi draf).

Terakhir diubah pada 7 November 2026