> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # 설문지 생성 API: 맞춤형 KYC 양식 > 순서가 지정된 질문, 선택지, 54개 언어 번역으로 맞춤형 KYC 및 컴플라이언스 설문지를 프로그래밍 방식으로 생성하세요. Didit의 호출당 과금 방식. 설문지 생성 API 프롬프트 프롬프트를 클립보드에 복사 \

\`Create a simple Didit questionnaire through the Management API.

Endpoint:
POST https://verification.didit.me/v3/questionnaires/

Authentication:
Use the x-api-key header with my Didit API key.

Requirements:
\- Use the simple v3 API shape with form_elements.
\- Do not send graph, branches, next, required_if, or conditional logic.
\- Include languages with en and default_language set to en.
\- Use customer-friendly element_type values such as short_text, multiple_choice, email, file_upload, or date_picker.
\- For choice questions, send options with value and label.
\- Store the questionnaire_id from the response because I will use it later as questionnaire_uuid in workflows.

Example request body:
\{
"title": "Customer Onboarding",
"languages": ["en"],
"default_language": "en",
"form_elements": [
\{
  "id": "occupation",
  "element_type": "short_text",
  "label": { "en": "What is your occupation?" },
  "is_required": true
},
\{
  "id": "source_of_funds",
  "element_type": "multiple_choice",
  "label": { "en": "Source of funds" },
  "is_required": true,
  "options": [
    \{ "value": "employment", "label": { "en": "Employment" } },
    \{ "value": "business", "label": { "en": "Business" } },
    \{ "value": "investments", "label": { "en": "Investments" } }
  ]
}
]
}

Build the API call, handle validation errors, and return the questionnaire_id from the response.`

\
붙여넣을 곳 이 엔드포인트를 사용하면 API로 간단한 설문지를 생성할 수 있습니다. 사용자가 답변할 순서대로 `form_elements` 배열을 보내십시오. Didit이 내부 설문지 그래프를 자동으로 구성합니다.API는 단순 선형 설문지만 지원합니다. `graph`, `branches`, `next` 또는 조건부 규칙은 보내지 마십시오.## 필수 필드- `title`은 내부에서 사용하는 설문지 이름입니다. - `languages`에는 `en`이 반드시 포함되어야 합니다. - `form_elements`에는 질문이 하나 이상 있어야 합니다. - 각 양식 요소에는 `element_type`과 번역된 `label`이 있어야 합니다.양식 요소에 선택 사항인 번역된 `description`을 추가하여 도움말 텍스트로 사용할 수 있습니다. `separator`를 제외한 모든 요소 유형에서 허용되며, [설문지 보고서](https://docs.didit.me/ko/core-technology/questionnaires/report-questionnaire.md)에서 항목의 `description`으로 반환됩니다.## 요소 유형`short_text`, `multiple_choice`, `email`, `file_upload`, `date_picker`와 같이 소문자 값을 사용하십시오. `SHORT_TEXT`와 같은 대문자 열거형 값도 허용됩니다.`dropdown`, `single_choice`, `multiple_choice`에는 `options`를 추가하십시오. 옵션의 `value`를 생략하면 Didit이 레이블에서 값을 생성합니다.```json theme={null} { "title": "Customer Onboarding", "languages": ["en"], "default_language": "en", "form_elements": [ { "id": "occupation", "element_type": "short_text", "label": { "en": "What is your occupation?" }, "is_required": true }, { "id": "source_of_funds", "element_type": "multiple_choice", "label": { "en": "Source of funds" }, "is_required": true, "options": [ { "value": "employment", "label": { "en": "Employment" } }, { "value": "business", "label": { "en": "Business" } }, { "value": "investments", "label": { "en": "Investments" } } ] } ] } ```## 필드 검증`short_text`, `long_text`, `number` 요소에 선택 사항인 `validation` 객체를 추가하면 사용자 답변의 형식을 강제할 수 있습니다. 납세자 번호, 국가 식별 번호, 카드 번호처럼 엄격한 형식이 있는 식별자에 유용합니다. 검증은 사용자가 필드를 채우는 동안 실행되며(통과하지 못하면 사용자는 다음 단계로 진행할 수 없습니다), 제출 시 API가 다시 한 번 강제합니다.| 필드 | 적용 대상 | 설명 | | - | - | - | | `pattern` | `short_text`, `long_text` | 값 전체가 일치해야 하는 정규 표현식입니다. 이식성이 있는 ECMA-262 하위 집합을 사용하고, `^`/`$` 앵커는 추가하지 마십시오(전체 값이 일치 대상입니다). | | `min_length` | `short_text`, `long_text` | 최소 문자 수입니다. | | `max_length` | `short_text`, `long_text` | 최대 문자 수입니다. | | `min` | `number` | 최소 숫자 값입니다. | | `max` | `number` | 최대 숫자 값입니다. | | `error_message` | 위의 모든 항목 | 값이 검증을 통과하지 못했을 때 표시되는 번역된 메시지입니다. 생략하면 일반 메시지로 대체됩니다. |```json theme={null} { "title": "Customer Onboarding", "languages": ["en"], "default_language": "en", "form_elements": [ { "id": "tax_id", "element_type": "short_text", "label": { "en": "Tax ID" }, "is_required": true, "validation": { "pattern": "[A-Z]{2}[0-9]{9}", "min_length": 11, "max_length": 11, "error_message": { "en": "Enter a valid Tax ID (2 letters followed by 9 digits)." } } } ] } ```응답에는 `questionnaire_id`가 포함됩니다. 이 값을 저장해 두십시오. 설문지를 워크플로에 추가할 때 `questionnaire_uuid`로 사용합니다. ## OpenAPI ````yaml ko/openapi-25.json POST /v3/questionnaires/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: 신분증 인증 API입니다. x-api-key 헤더로 인증합니다. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/questionnaires/: post: tags: - Questionnaires summary: 설문지 생성 description: >- 단순한 선형 설문지를 생성합니다. `form_elements`를 표시 순서대로 전송하십시오. 분기 및 반복 가능한 그룹은 콘솔을 사용해야 합니다. 기본값은 `published` v1입니다. operationId: create_questionnaire requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SimpleQuestionnaireRequest' examples: Simple: summary: 기본 설문지 value: title: Customer Onboarding description: Additional information needed for verification default_language: en languages: - en is_active: true form_elements: - id: occupation element_type: short_text label: en: What is your occupation? is_required: true placeholder: en: Software engineer - id: source_of_funds element_type: multiple_choice label: en: Source of funds is_required: true options: - value: employment label: en: Employment - value: business label: en: Business - value: investments label: en: Investments - value: other label: en: Other responses: '201': description: >- 설문지가 생성되었습니다. 응답에는 `questionnaire_id`가 포함됩니다. 워크플로 또는 향후 업데이트/삭제 호출에서 이 설문지를 참조할 수 있도록 저장하십시오. content: application/json: schema: $ref: '#/components/schemas/QuestionnaireDetail' examples: Created: value: questionnaire_id: 11111111-2222-3333-4444-555555555555 title: Customer Onboarding description: Additional information needed for verification languages: - en default_language: en is_active: true is_simple_questionnaire: true graph: start_node: occupation nodes: occupation: element_type: SHORT_TEXT is_required: true title: en: What is your occupation? next: source_of_funds source_of_funds: element_type: MULTIPLE_CHOICE is_required: true title: en: Source of funds choices: - value: employment label: en: Employment - value: business label: en: Business next: null sections: [] questionnaire_group_id: 11111111-2222-3333-4444-555555555555 version: 1 status: published published_at: '2026-04-23T10:00:00Z' is_editable: false '400': description: >- 유효성 검사 오류입니다. 일반적인 원인: 알 수 없는 `element_type`, `languages` 중 하나에 대한 번역이 누락된 번역 가능 필드, `languages`에 `en` 누락, `default_language`가 `languages`에 없음, `label`이 없는 옵션, `branches`/`required_if`/`repeatable_config`가 포함된 질문(이 endpoint에서는 지원되지 않음), 또는 `form_elements` 대신 원시 `graph` 전송입니다. 본문은 필드 이름을 키로 하는 DRF 유효성 검사 오류입니다. content: application/json: examples: Graph not accepted: value: graph: >- The v3 questionnaire API only accepts simple `form_elements`, not `graph`. Missing label: value: form_elements: - label: - This field is required. '403': description: API 키가 누락되었거나, 형식이 잘못되었거나, 만료되었거나, 다른 애플리케이션으로 범위가 지정되었습니다. content: application/json: examples: Invalid token: value: detail: You do not have permission to perform this action. '415': description: >- 지원되지 않는 미디어 유형입니다. `Content-Type: application/json`으로 설정하고 JSON 본문을 전송하십시오. '429': description: 속도 제한을 초과했습니다. 지수 백오프로 재시도하세요. '500': description: 설문지를 생성하는 동안 예기치 않은 서버 오류가 발생했습니다. 안전하게 재시도할 수 있습니다. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: cURL source: |- curl -X POST 'https://verification.didit.me/v3/questionnaires/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "title": "Customer Onboarding", "default_language": "en", "languages": ["en"], "form_elements": [ { "id": "occupation", "element_type": "short_text", "label": {"en": "What is your occupation?"}, "is_required": true } ] }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.questionnaires.create( title="Customer Onboarding", description="Additional information needed for verification", languages=["en"], default_language="en", is_active=True, form_elements=[{ "id": "occupation", "element_type": "short_text", "label": {"en": "What is your occupation?"}, "placeholder": {"en": "Software engineer"}, "is_required": True, }, { "id": "source_of_funds", "element_type": "multiple_choice", "label": {"en": "Source of funds"}, "is_required": True, "options": [{ "value": "employment", "label": {"en": "Employment"}, }, { "value": "business", "label": {"en": "Business"}, }, { "value": "investments", "label": {"en": "Investments"}, }, { "value": "other", "label": {"en": "Other"}, }], }], ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.questionnaires.create({ title: "Customer Onboarding", description: "Additional information needed for verification", languages: ["en"], default_language: "en", is_active: true, form_elements: [{ id: "occupation", element_type: "short_text", label: { en: "What is your occupation?" }, placeholder: { en: "Software engineer" }, is_required: true, }, { id: "source_of_funds", element_type: "multiple_choice", label: { en: "Source of funds" }, is_required: true, options: [{ value: "employment", label: { en: "Employment" }, }, { value: "business", label: { en: "Business" }, }, { value: "investments", label: { en: "Investments" }, }, { value: "other", label: { en: "Other" }, }], }], }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Questionnaires.Create(ctx, didit.SimpleQuestionnaireRequest{\n\tTitle: \"Customer Onboarding\",\n\tDescription: didit.String(\"Additional information needed for verification\"),\n\tLanguages: []string{\"en\"},\n\tDefaultLanguage: didit.String(\"en\"),\n\tIsActive: didit.Bool(true),\n\tFormElements: []didit.SimpleQuestionnaireElement{{\n\t\tID: didit.String(\"occupation\"),\n\t\tElementType: \"short_text\",\n\t\tLabel: map[string]string{\"en\": \"What is your occupation?\"},\n\t\tPlaceholder: didit.Some(map[string]string{\"en\": \"Software engineer\"}),\n\t\tIsRequired: didit.Bool(true),\n\t}, {\n\t\tID: didit.String(\"source_of_funds\"),\n\t\tElementType: \"multiple_choice\",\n\t\tLabel: map[string]string{\"en\": \"Source of funds\"},\n\t\tIsRequired: didit.Bool(true),\n\t\tOptions: didit.Some([]didit.SimpleQuestionnaireElementOptions{{\n\t\t\tValue: didit.String(\"employment\"),\n\t\t\tLabel: map[string]string{\"en\": \"Employment\"},\n\t\t}, {\n\t\t\tValue: didit.String(\"business\"),\n\t\t\tLabel: map[string]string{\"en\": \"Business\"},\n\t\t}, {\n\t\t\tValue: didit.String(\"investments\"),\n\t\t\tLabel: map[string]string{\"en\": \"Investments\"},\n\t\t}, {\n\t\t\tValue: didit.String(\"other\"),\n\t\t\tLabel: map[string]string{\"en\": \"Other\"},\n\t\t}}),\n\t}},\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import java.util.List; import java.util.Map; import me.didit.Didit; import me.didit.types.SimpleQuestionnaireElement; import me.didit.types.SimpleQuestionnaireRequest; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.questionnaires().create(SimpleQuestionnaireRequest.builder() .title("Customer Onboarding") .description("Additional information needed for verification") .languages(List.of("en")) .defaultLanguage("en") .isActive(true) .formElements(List.of( SimpleQuestionnaireElement.builder() .id("occupation") .elementType(SimpleQuestionnaireElement.ElementType.of("short_text")) .label(Map.of("en", "What is your occupation?")) .placeholder(Map.of("en", "Software engineer")) .isRequired(true) .build(), SimpleQuestionnaireElement.builder() .id("source_of_funds") .elementType(SimpleQuestionnaireElement.ElementType.of("multiple_choice")) .label(Map.of("en", "Source of funds")) .isRequired(true) .options(List.of( SimpleQuestionnaireElement.Options.builder() .value("employment") .label(Map.of("en", "Employment")) .build(), SimpleQuestionnaireElement.Options.builder() .value("business") .label(Map.of("en", "Business")) .build(), SimpleQuestionnaireElement.Options.builder() .value("investments") .label(Map.of("en", "Investments")) .build(), SimpleQuestionnaireElement.Options.builder() .value("other") .label(Map.of("en", "Other")) .build())) .build())) .build()); System.out.println(result); - lang: php label: PHP source: |- questionnaires->create([ 'title' => 'Customer Onboarding', 'description' => 'Additional information needed for verification', 'languages' => ['en'], 'default_language' => 'en', 'is_active' => true, 'form_elements' => [[ 'id' => 'occupation', 'element_type' => 'short_text', 'label' => ['en' => 'What is your occupation?'], 'placeholder' => ['en' => 'Software engineer'], 'is_required' => true, ], [ 'id' => 'source_of_funds', 'element_type' => 'multiple_choice', 'label' => ['en' => 'Source of funds'], 'is_required' => true, 'options' => [[ 'value' => 'employment', 'label' => ['en' => 'Employment'], ], [ 'value' => 'business', 'label' => ['en' => 'Business'], ], [ 'value' => 'investments', 'label' => ['en' => 'Investments'], ], [ 'value' => 'other', 'label' => ['en' => 'Other'], ]], ]], ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.questionnaires.create( title: "Customer Onboarding", description: "Additional information needed for verification", languages: ["en"], default_language: "en", is_active: true, form_elements: [{ id: "occupation", element_type: "short_text", label: { en: "What is your occupation?" }, placeholder: { en: "Software engineer" }, is_required: true, }, { id: "source_of_funds", element_type: "multiple_choice", label: { en: "Source of funds" }, is_required: true, options: [{ value: "employment", label: { en: "Employment" }, }, { value: "business", label: { en: "Business" }, }, { value: "investments", label: { en: "Investments" }, }, { value: "other", label: { en: "Other" }, }], }] ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Collections.Generic; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Questionnaires.CreateAsync(new SimpleQuestionnaireRequest { Title = "Customer Onboarding", Description = "Additional information needed for verification", Languages = new string[] { "en" }, DefaultLanguage = "en", IsActive = true, FormElements = new SimpleQuestionnaireElement[] { new() { Id = "occupation", ElementType = "short_text", Label = new Dictionary { ["en"] = "What is your occupation?" }, Placeholder = new Dictionary { ["en"] = "Software engineer" }, IsRequired = true, }, new() { Id = "source_of_funds", ElementType = "multiple_choice", Label = new Dictionary { ["en"] = "Source of funds" }, IsRequired = true, Options = new SimpleQuestionnaireElementOptions[] { new() { Value = "employment", Label = new Dictionary { ["en"] = "Employment" }, }, new() { Value = "business", Label = new Dictionary { ["en"] = "Business" }, }, new() { Value = "investments", Label = new Dictionary { ["en"] = "Investments" }, }, new() { Value = "other", Label = new Dictionary { ["en"] = "Other" }, }, }, }, }, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: SimpleQuestionnaireRequest: type: object description: 단순한 선형 설문지를 생성합니다. API는 `form_elements`를 내부 설문지 그래프로 변환합니다. required: - title - languages - form_elements properties: title: type: string description: 설문지의 내부 이름입니다. description: type: string nullable: true languages: type: array description: 모든 라벨에 포함된 언어입니다. `en`이 반드시 포함되어야 합니다. items: type: string example: - en default_language: type: string description: 기본 언어입니다. `languages`에 포함되어 있어야 합니다. example: en is_active: type: boolean default: true status: type: string enum: - draft - published description: 워크플로에 사용할 수 있는 게시된 설문지를 생성하려면 이 필드를 생략하세요. form_elements: type: array minItems: 1 description: 사용자에게 표시되어야 하는 정확한 순서의 질문 목록입니다. 분기 및 조건부 필드는 지원되지 않습니다. items: $ref: '#/components/schemas/SimpleQuestionnaireElement' QuestionnaireDetail: type: object description: GET, POST(생성) 및 PATCH(업데이트) endpoint에서 반환되는 설문지 전체 세부정보입니다. properties: questionnaire_id: type: string format: uuid description: 설문지의 고유 식별자입니다. 워크플로에서 설문지를 참조하거나 이후 업데이트/삭제 요청 시 이 id를 사용합니다. title: type: string description: type: string nullable: true languages: type: array items: type: string default_language: type: string is_active: type: boolean is_simple_questionnaire: type: boolean graph: type: object description: start_node 및 노드 맵이 포함된 그래프 구조입니다. sections: type: array description: 섹션별로 그룹화된 설문지 내용(그래프에서 파생됨). items: type: object questionnaire_group_id: type: string format: uuid description: 동일한 설문지의 모든 버전을 그룹화하는 고정 식별자입니다. version: type: integer status: type: string enum: - draft - published published_at: type: string format: date-time nullable: true is_editable: type: boolean description: 설문지를 직접 계속 편집할 수 있는 경우 true입니다(초안 버전). SimpleQuestionnaireElement: type: object required: - element_type - label properties: id: type: string description: >- 선택 사항인 안정적인 질문 ID입니다. 생략하면 API가 `q1`, `q2` 등을 생성합니다. 가독성을 위해 소문자, 숫자, 밑줄을 사용하세요. example: source_of_funds element_type: type: string description: 질문 유형입니다. API는 이러한 소문자 값 및 이에 해당하는 대문자 값을 허용합니다. enum: - short_text - long_text - dropdown - single_choice - multiple_choice - number - image - file_upload - time - email - address - phone - country - date_picker - consent - section_header - separator - heading - paragraph label: type: object description: '언어 코드별 질문 라벨(예: `{ "en": "Source of funds" }`).' additionalProperties: type: string description: type: object nullable: true additionalProperties: type: string placeholder: type: object nullable: true additionalProperties: type: string is_required: type: boolean default: false options: type: array description: >- `dropdown`, `single_choice`, `multiple_choice`에 사용합니다. `value`를 생략하면 API가 옵션 레이블을 기반으로 값을 생성합니다. items: type: object required: - label properties: value: type: string label: type: object additionalProperties: type: string max_files: type: integer minimum: 1 maximum: 5 description: '`file_upload` 또는 `image`와 함께 사용합니다.' validation: type: object nullable: true description: >- `short_text`, `long_text` 또는 `number`에 대한 선택적 형식 유효성 검사입니다. 사용자가 필드를 채우는 동안 적용되며(통과할 때까지 계속 진행할 수 없음), 제출 시 API를 통해 다시 확인됩니다. properties: pattern: type: string description: >- 값이 완전히 일치해야 하는 정규식(ECMA-262 하위 집합)입니다. `short_text` 및 `long_text`용입니다. ^/$ 앵커를 추가하지 마십시오. 전체 값과 일치합니다. min_length: type: integer minimum: 0 description: 최소 글자 수입니다. `short_text` 및 `long_text`에 사용됩니다. max_length: type: integer minimum: 0 description: 최대 문자 수입니다. `short_text` 및 `long_text`에 사용됩니다. min: type: number description: 최소 숫자 값입니다. `number`에 사용됩니다. max: type: number description: 최대 숫자 값입니다. `number`에 사용됩니다. error_message: type: object description: 검증 실패 시 표시되는 번역된 메시지이며, 언어 코드로 키가 지정됩니다. additionalProperties: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- 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 를 참고하십시오. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.