메인 콘텐츠로 건너뛰기
PATCH
cURL
PATCH를 사용해 부분 업데이트를 합니다. 설문지 이름을 바꾸려면 title 또는 description만 보내면 됩니다.
질문을 업데이트하려면 원하는 전체 form_elements 배열을 보내야 합니다. 이 배열은 기존 질문 목록을 대체합니다. 계속 표시하려는 기존 질문은 함께 포함하세요.
v3 API는 단순한 선형 설문지만 지원합니다. graph, branches, next, 조건부 규칙이 포함된 요청은 거부됩니다. 응답에는 questionnaire_id가 포함됩니다. published 상태의 설문지를 업데이트하면 API가 새 버전을 만들 수 있습니다. 반환된 questionnaire_id를 저장해 워크플로에서 사용하고, URL의 ID가 여전히 최신 버전이라고 가정하지 마세요.

인증

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 를 참고하십시오.

경로 매개변수

questionnaire_uuid
string<uuid>
필수

업데이트할 설문지의 버전별 UUID입니다.

본문

application/json

설문지 메타데이터를 업데이트하거나 전체 선형 form_elements 목록을 대체합니다.

title
string
description
string | null
languages
string[]
default_language
string
is_active
boolean
status
enum<string>
사용 가능한 옵션:
draft,
published
form_elements
object[]

제공된 경우 전체 선형 질문 목록을 대체합니다.

Minimum array length: 1

응답

설문지가 업데이트되었습니다. 본문은 결과 버전의 최신 상태입니다. 제자리에서 업데이트된 버전이거나, 게시된 행에 status: "published"를 전송했을 때 새로 생성된 게시 버전입니다(이 경우 questionnaire_id 및 version은 패치한 값과 다릅니다). 응답의 questionnaire_id는 버전별 UUID입니다. 안정적인 그룹 식별자가 필요한 경우 questionnaire_group_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일