메인 콘텐츠로 건너뛰기
POST
cURL
이 엔드포인트를 사용하면 API로 간단한 설문지를 생성할 수 있습니다. 사용자가 답변할 순서대로 form_elements 배열을 보내십시오. Didit이 내부 설문지 그래프를 자동으로 구성합니다. API는 단순 선형 설문지만 지원합니다. graph, branches, next 또는 조건부 규칙은 보내지 마십시오.

필수 필드

  • title은 내부에서 사용하는 설문지 이름입니다.
  • languages에는 en이 반드시 포함되어야 합니다.
  • form_elements에는 질문이 하나 이상 있어야 합니다.
  • 각 양식 요소에는 element_type과 번역된 label이 있어야 합니다.
양식 요소에 선택 사항인 번역된 description을 추가하여 도움말 텍스트로 사용할 수 있습니다. separator를 제외한 모든 요소 유형에서 허용되며, 설문지 보고서에서 항목의 description으로 반환됩니다.

요소 유형

short_text, multiple_choice, email, file_upload, date_picker와 같이 소문자 값을 사용하십시오. SHORT_TEXT와 같은 대문자 열거형 값도 허용됩니다. dropdown, single_choice, multiple_choice에는 options를 추가하십시오. 옵션의 value를 생략하면 Didit이 레이블에서 값을 생성합니다.

필드 검증

short_text, long_text, number 요소에 선택 사항인 validation 객체를 추가하면 사용자 답변의 형식을 강제할 수 있습니다. 납세자 번호, 국가 식별 번호, 카드 번호처럼 엄격한 형식이 있는 식별자에 유용합니다. 검증은 사용자가 필드를 채우는 동안 실행되며(통과하지 못하면 사용자는 다음 단계로 진행할 수 없습니다), 제출 시 API가 다시 한 번 강제합니다.
응답에는 questionnaire_id가 포함됩니다. 이 값을 저장해 두십시오. 설문지를 워크플로에 추가할 때 questionnaire_uuid로 사용합니다.

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

본문

application/json

단순한 선형 설문지를 생성합니다. API는 form_elements를 내부 설문지 그래프로 변환합니다.

title
string
필수

설문지의 내부 이름입니다.

languages
string[]
필수

모든 라벨에 포함된 언어입니다. en이 반드시 포함되어야 합니다.

예시:
form_elements
object[]
필수

사용자에게 표시되어야 하는 정확한 순서의 질문 목록입니다. 분기 및 조건부 필드는 지원되지 않습니다.

Minimum array length: 1
description
string | null
default_language
string

기본 언어입니다. languages에 포함되어 있어야 합니다.

예시:

"en"

is_active
boolean
기본값:true
status
enum<string>

워크플로에 사용할 수 있는 게시된 설문지를 생성하려면 이 필드를 생략하세요.

사용 가능한 옵션:
draft,
published

응답

설문지가 생성되었습니다. 응답에는 questionnaire_id가 포함됩니다. 워크플로 또는 향후 업데이트/삭제 호출에서 이 설문지를 참조할 수 있도록 저장하십시오.

GET, POST(생성) 및 PATCH(업데이트) endpoint에서 반환되는 설문지 전체 세부정보입니다.

questionnaire_id
string<uuid>

설문지의 고유 식별자입니다. 워크플로에서 설문지를 참조하거나 이후 업데이트/삭제 요청 시 이 id를 사용합니다.

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

start_node 및 노드 맵이 포함된 그래프 구조입니다.

sections
object[]

섹션별로 그룹화된 설문지 내용(그래프에서 파생됨).

questionnaire_group_id
string<uuid>

동일한 설문지의 모든 버전을 그룹화하는 고정 식별자입니다.

version
integer
status
enum<string>
사용 가능한 옵션:
draft,
published
published_at
string<date-time> | null
is_editable
boolean

설문지를 직접 계속 편집할 수 있는 경우 true입니다(초안 버전).

마지막 수정일 2026년 11월 7일