설문 상세정보 가져오기

특정 설문(form_id) 상세정보를 가져옵니다.

[GET] https://api.moaform.com/v1/forms/{form_id}

 

요청

Path Parameters

Key Description
form_id 필수, 설문의 고유 ID

 

응답

Key Type Description
id string 설문의 고유 ID
title string 설문 제목
status string 설문 진행 상태 (editing, pending, collecting, closed 중 하나)
pages [object]  
↳ id string 페이지의 고유 ID
↳ number integer 페이지 번호
↳ visible boolean 페이지 노출 여부
↳ blocks_count integer 포함한 항목 개수
blocks [object] (아래 별도 table 에서 설명. 각 blocks 별로 아래 ... 위치를 대체)
... ... ...
welcome_page object  
↳ content string 소개글 내용
thankyou_pages [object]  
↳ id string 맺음말 페이지 고유 id
↳ content string 맺음말 내용
variables [object]  
↳ id string 정의된 변수의 고유 id
↳ name string 정의된 변수 이름
↳ formula string 정의된 변수 수식
owned boolean  
created_at string 설문 생성 일시
last_updated_at string 설문 최종 수정 일시
published_at string 설문 최종 게시 일시

 

blocks 질문 유형별 상세 (위 응답 표의 blocks 아래 위치함)

정보

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string information
↳ index string P1B1형태의 항목 번호형식
↳ content string 정보글 내용
↳ ribbon_text string 정보글 제목
↳ properties object  
     ↳ visible boolean 항목 노출 여부
↳ page_id string

페이지의 고유 ID

 

장식선

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string line_shape
↳ index string P1B1형태의 항목 번호형식
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ shape string 선모양 (zigzag...)
↳ page_id string 페이지의 고유 ID

 

객관식 한 개 선택

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string single_choice
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ allow_other_choice boolean 기타 보기 허용 여부
     ↳ randomize boolean 보기 무작위 배열 여부
     ↳ assign_score boolean 점수 할당 여부
     ↳ choices [object]  
          ↳ id string 보기의 고유 ID
          ↳ index string P1B1C1형태의 보기 번호형식
          ↳ label string 보기 내용
          ↳ score integer 보기에 할당된 점수
          ↳ visible boolean 보기 노출 여부
          ↳ is_other boolean 기타 보기 여부 (allow_other_choice=true 일때만 나옴)
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ required_other boolean 기타 답변 입력 필수 여부
↳ page_id string 페이지의 고유 ID

 

드롭다운

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string dropdown
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ allow_other_choice boolean 기타 보기 허용 여부
     ↳ randomize boolean 보기 무작위 배열 여부
     ↳ assign_score boolean 점수 할당 여부
     ↳ choices [object]  
          ↳ id string 보기의 고유 ID
          ↳ index string P1B1C1형태의 보기 번호형식
          ↳ label string 보기 내용
          ↳ score integer 보기에 할당된 점수
          ↳ visible boolean 보기 노출 여부
          ↳ is_other boolean 기타 보기 여부 (allow_other_choice=true 일때만 나옴)
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ required_other boolean 기타 답변 입력 필수 여부 (allow_other_choice=true 일때만 나옴)
↳ page_id string 페이지의 고유 ID

 

객관식 복수 선택

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string multiple_choice
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ allow_other_choice boolean 기타 보기 허용 여부
     ↳ randomize boolean 보기 무작위 배열 여부
     ↳ assign_score boolean 점수 할당 여부
     ↳ choices [object]  
          ↳ id string 보기의 고유 ID
          ↳ index string P1B1C1형태의 보기 번호형식
          ↳ label string 보기 내용
          ↳ score integer 보기에 할당된 점수
          ↳ visible boolean 보기 노출 여부
          ↳ is_other boolean 기타 보기 여부 (allow_other_choice=true 일때만 나옴)
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ required_other boolean 기타 답변 입력 필수 여부 (allow_other_choice=true 일때만 나옴)
     ↳ min_selection integer 최소 보기 선택 개수
     ↳ max_selection integer 최대 보기 선택 개수
↳ page_id string 페이지의 고유 ID

 

순위형

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string ranking
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties [object]  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ allow_other_choice boolean 기타 보기 허용 여부
     ↳ randomize boolean 보기 무작위 배열 여부
     ↳ choices [object]  
          ↳ id string 보기의 고유 ID
          ↳ index string P1B1C1형태의 보기 번호형식
          ↳ label string 보기 내용
          ↳ visible boolean 보기 노출 여부
          ↳ is_other boolean 기타 보기 여부 (allow_other_choice=true 일때만 나옴)
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ required_other boolean 기타 답변 입력 필수 여부 (allow_other_choice=true 일때만 나옴)
     ↳ min_selection integer 최소 보기 선택 개수
     ↳ max_selection integer 최대 보기 선택 개수
↳ page_id string 페이지의 고유 ID

 

격자형 한 개 선택

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string matrix_single_choice
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ assign_score boolean 점수 할당 여부
↳ blocks [object]  
     ↳ id string 소질문의 고유 ID
     ↳ index string P1B1.1형태의 소질문 번호형식
     ↳ content string 소질문 내용
     ↳ visible boolean 소질문 노출 여부
     ↳ properties object  
          ↳ choices [object]  
               ↳ id string 보기의 고유 ID
               ↳ index string P1B1.1C1형태의 보기 번호형식
               ↳ label string 보기 내용
               ↳ score integer 보기에 할당된 점수
               ↳ visible boolean 보기 노출 여부
↳ validations object  
     ↳ required boolean 답변 필수 여부
↳ page_id string 페이지의 고유 ID

 

격자형 복수 선택

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string matrix_multiple_choice
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ assign_score boolean 점수 할당 여부
↳ blocks [object]  
     ↳ id string 소질문의 고유 ID
     ↳ index string P1B1.1형태의 소질문 번호형식
     ↳ content string 소질문 내용
     ↳ visible boolean 소질문 노출 여부
     ↳ properties object  
          ↳ choices [object]  
               ↳ id string 보기의 고유 ID
               ↳ index string P1B1.1C1형태의 보기 번호형식
               ↳ label string 보기 내용
               ↳ score integer 보기에 할당된 점수
               ↳ visible boolean 보기 노출 여부
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ min_selection integer 최소 보기 선택 개수
     ↳ max_selection integer 최대 보기 선택 개수
↳ page_id string 페이지의 고유 ID

 

격자형 순위형

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string matrix_ranking
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
↳ blocks [object]  
     ↳ id string 소질문의 고유 ID
     ↳ index string P1B1.1형태의 소질문 번호형식
     ↳ content string 소질문 내용
     ↳ visible boolean 소질문 노출 여부
     ↳ properties object  
          ↳ choices [object]  
               ↳ id string 보기의 고유 ID
               ↳ index string P1B1.1C1형태의 보기 번호형식
               ↳ label string 보기 내용
               ↳ visible boolean 보기 노출 여부
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ min_selection integer 최소 보기 선택 개수
     ↳ max_selection integer 최대 보기 선택 개수
↳ page_id string 페이지의 고유 ID

 

미디어 한 개 선택

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string media_single_choice
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ allow_other_choice boolean 기타 보기 허용 여부
     ↳ randomize boolean 보기 무작위 배열 여부
     ↳ assign_score boolean 점수 할당 여부
     ↳ choices [object]  
          ↳ id string 보기의 고유 ID
          ↳ index string P1B1C1형태의 보기 번호형식
          ↳ label string 보기 내용
          ↳ score integer 보기에 할당된 점수
          ↳ visible boolean 보기 노출 여부
          ↳ is_other boolean 기타 보기 여부 (allow_other_choice = true 일때만 나옴)
          ↳ media object 첨부한 이미지가 없거나 기타일때는 이 항목은 나오지 않음
               ↳ type string 미디어 종류 (현재는 image로만 반환)
               ↳ url string 이미지 링크 주소
               ↳ width integer 이미지 width
               ↳ height integer 이미지 height
     ↳ media object  
          ↳ fill string 보기내 이미지 채우기
          ↳ size string 보기내 이미지 사이즈
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ required_other boolean 기타 답변 입력 필수 여부 (allow_other_choice=true 일때만 나옴)
↳ page_id string 페이지의 고유 ID

 

미디어 복수 선택

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string media_multiple_choice
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ allow_other_choice boolean 기타 보기 허용 여부
     ↳ randomize boolean 보기 무작위 배열 여부
     ↳ assign_score boolean 점수 할당 여부
     ↳ choices [object]  
          ↳ id string 보기의 고유 ID
          ↳ index string P1B1C1형태의 보기 번호형식
          ↳ label string 보기 내용
          ↳ score integer 보기에 할당된 점수
          ↳ visible boolean 보기 노출 여부
          ↳ is_other boolean 기타 보기 여부 (allow_other_choice = true일때만 나옴)
          ↳ media object 첨부한 이미지가 없거나 기타일때는 이 항목은 나오지 않음
               ↳ type string 미디어 종류 (현재는 image로만 반환)
               ↳ url string 이미지 링크 주소
               ↳ width integer 이미지 width
               ↳ height integer 이미지 height
     ↳ media object  
          ↳ fill string 보기내 이미지 채우기
          ↳ size string 보기내 이미지 사이즈
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ required_other boolean 기타 답변 입력 필수 여부 (allow_other_choice=true 일때만 나옴)
     ↳ min_selection integer 최소 보기 선택 개수
     ↳ max_selection integer 최대 보기 선택 개수
↳ page_id string 페이지의 고유 ID

 

미디어 순위형

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string media_ranking
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ allow_other_choice boolean 기타 보기 허용 여부
     ↳ randomize boolean 보기 무작위 배열 여부
     ↳ choices [object]  
          ↳ id string 보기의 고유 ID
          ↳ index string P1B1C1형태의 보기 번호형식
          ↳ label string 보기 내용
          ↳ score integer 보기에 할당된 점수
          ↳ visible boolean 보기 노출 여부
          ↳ is_other boolean 기타 보기 여부 (allow_other_choice = true일때만 나옴)
          ↳ media object 첨부한 이미지가 없거나 기타일때는 이 항목은 나오지 않음
               ↳ type string 미디어 종류 (현재는 image로만 반환)
               ↳ url string 이미지 링크 주소
               ↳ width integer 이미지 width
               ↳ height integer 이미지 height
     ↳ media object  
          ↳ fill string 보기내 이미지 채우기
          ↳ size string 보기내 이미지 사이즈
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ required_other boolean 기타 답변 입력 필수 여부 (allow_other_choice=true 일때만 나옴)
     ↳ min_selection integer 최소 보기 선택 개수
     ↳ max_selection integer 최대 보기 선택 개수
↳ page_id string 페이지의 고유 ID

 

척도형

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string point_scale
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ shape boolean 척도 모양
     ↳ steps integer 척도 단계
     ↳ scales [integer] 척도 범위 (예: [-5, -4, -3, -2, -1, 0, 1, 2, 3, 4, 5])
     ↳ label [object]  
         ↳ left string 척도 좌측 문구
          ↳ center string 척도 가운데 문구
          ↳ right string 척도 우측 문구
↳ validations object  
     ↳ required boolean 답변 필수 여부
↳ page_id string 페이지의 고유 ID

 

NPS

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string nps
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ shape boolean 척도 모양
     ↳ steps integer 척도 단계 (11로 고정)
     ↳ scales [integer] 척도 범위 ([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]로 고정)
↳ validations object  
     ↳ required boolean 답변 필수 여부
↳ page_id string 페이지의 고유 ID

 

별점형

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string rating
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ shape boolean 별점형 모양
     ↳ steps integer 별점 단계
     ↳ show_step_count boolean 점수 표시 여부
↳ validations object  
     ↳ required boolean 답변 필수 여부
↳ page_id string 페이지의 고유 ID

 

주관식 긴 답변 (자유형식)

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string long_text
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ encrypted_answer boolean 답변 암호화 저장 여부
     ↳ format string 답변 형식 설정 (free, regex)
     ↳ guide_phrase string 안내 문구
     ↳ size string 입력칸 크기 (large, small)
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ min_character integer 최소 글자수(기본값 1)
     ↳ max_character integer 최대 글자수(기본값 null: 무제한)
↳ page_id string 페이지의 고유 ID

 

주관식 긴 답변 (정규표현식)

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string long_text
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ encrypted_answer boolean 답변 암호화 저장 여부
     ↳ format string 답변 형식 설정 (free, regex)
     ↳ error_text string 오류 메시지
     ↳ guide_phrase string 안내 문구
     ↳ size string 입력칸 크기 (large, small)
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ condition string 정규 표현식 데이터 조건
     ↳ pattern string 정규 표현식 데이터 패턴
↳ page_id string 페이지의 고유 ID

 

주관식 짧은 답변 (자유형식)

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string short_text
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ encrypted_answer boolean 답변 암호화 저장 여부
     ↳ format string 답변 형식 설정 (free, regex)
     ↳ guide_phrase string 안내 문구
     ↳ size string 입력칸 크기 (long, medium)
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ min_character integer 최소 글자수(기본값 1)
     ↳ max_character integer 최대 글자수(기본값 null: 무제한)
     ↳ no_spacing boolean 띄워쓰기 금지 여부
↳ page_id string 페이지의 고유 ID

 

주관식 짧은 답변 (정규표현식)

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string short_text
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ encrypted_answer boolean 답변 암호화 저장 여부
     ↳ format string 답변 형식 설정 (free, regex)
     ↳ error_text string 오류 메시지
     ↳ guide_phrase string 안내 문구
     ↳ size string 입력칸 크기 (long, medium)
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ condition string 정규 표현식 데이터 조건
     ↳ pattern string 정규 표현식 데이터 패턴
↳ page_id string 페이지의 고유 ID

 

수치입력형

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string numeric_value
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ encrypted_answer boolean 답변 암호화 저장 여부
     ↳ guide_phrase string 안내 문구
     ↳ size string 입력칸 크기 (long, medium)
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ decimal_places integer 소수점 제한(0 ~ 5)
     ↳ min_number integer 입력 범위(최소값)
     ↳ max_number integer 입력 범위(최대값)
↳ page_id string 페이지의 고유 ID

 

이메일 주소

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string email
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ encrypted_answer boolean 답변 암호화 저장 여부
     ↳ guide_phrase string 안내 문구
     ↳ size string  입력칸 크기 (long, medium)
↳ validations object  
     ↳ required boolean 답변 필수 여부
↳ page_id string 페이지의 고유 ID

 

웹주소

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string url
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ encrypted_answer boolean 답변 암호화 저장 여부
     ↳ guide_phrase string 안내 문구
     ↳ size string  입력칸 크기 (long, medium)
↳ validations object  
     ↳ required boolean 답변 필수 여부
↳ page_id string 페이지의 고유 ID

 

주소

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string address
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
     ↳ encrypted_answer boolean 답변 암호화 저장 여부
     ↳ address_type string 주소 형식 (general, korean)
     ↳ visible_fields [string] 노출되는 주소 필드 (street, detail, city, region, postal_code, country)
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ required_fields [string] 필수 입력 주소 필드 (street, detail, city,r egion, postal_code, country)
↳ page_id string 페이지의 고유 ID

 

파일 업로드

KEY Type Description
↳ id string 항목의 고유 ID
↳ type string file_upload
↳ index string P1B1형태의 항목 번호형식
↳ content string 질문 내용
↳ properties object  
     ↳ visible boolean 항목 노출 여부
     ↳ hide_result boolean 결과 비공개 여부
↳ validations object  
     ↳ required boolean 답변 필수 여부
     ↳ file_extensions string 업로드 가능한 파일 확장자 종류 (콤마로 구분하는 문자열)
     ↳ min_files integer 업로드 가능한 최소 파일 개수
     ↳ max_files integer 업로드 가능한 최대 파일 개수
↳ page_id string 페이지의 고유 ID