Form API

Form API로 설문 결과를 조회할 수 있다.
Form API를 호출하려면 구성원 계정으로 인증하여 얻은 Access Token이 필요하다. 서비스 계정으로 인증하여 얻은 Access Token으로는 API를 호출할 수 없다.
API scope는 form, form.read이다.

설문 응답 결과 조회 {#get-form-response}

설문 응답 결과를 조회할 수 있다.

HTTP RequestDescription
GET /forms/{formId}/responses설문 응답 결과 조회
GET /forms/{formId}/responses/{responseId}/attachments/{attachmentId}설문 응답 파일 조회

참고

파일 다운로드 방법은 파일 업로드/다운로드를 참고한다.


설문 응답 결괏값 {#form-answer-value}

설문 응답 결과 조회 시 얻을 수 있는 Response는 모두 문자열(String)로 이루어져 있지만, 종류에 따라 형식이 다르다.

questionTypeanswer
SINGLE_CHOICE , MULTIPLE_CHOICE , TEXT , DROPDOWN형식 없음. 각 항목의 값이다.
RATING숫자.

예시) "1", "2.5"
SINGLE_DATE , MULTIPLE_DATE , DATE_INPUT , DATETIME_INPUT날짜 또는 날짜와 시간 형식.

예시)
- 2025.04.01 (화) → "2025-04-01"
(YYYY-MM-DD)
- 2025.04.01 (화) 09:30 → "2025-04-01T09:30:00+09:00"
(YYYY-MM-DDThh:mm:ssTZD)
- 2025.04.01 (화) 09:30 ~ 15:00 → "2025-04-01T09:30:00+09:00/2025-04-01T15:00:00+09:00"
(YYYY-MM-DDThh:mm:ssTZD/YYYY-MM-DDThh:mm:ssTZD)
- 2025.04.01 (화) 오전 → "2025-04-01T00:00:00+09:00/2025-04-01T11:59:59+09:00"
- 2025.04.01 (화) 오후 → "2025-04-01T12:00:00+09:00/2025-04-01T23:59:59+09:00"
ATTACHMENTattachmentId.

파일의 취득 방법은 설문 응답 파일 조회를 참고한다.

formId 확인 방법 {#how-to-get-formid}

Form API는 formId를 사용하여 조회하려는 설문을 지정한다.

formId는 PC 브라우저 버전의 NAVER WORKS 설문 URL에서 확인할 수 있다.

  1. 설문 목록 화면에서 formId를 확인하고 싶은 설문를 선택한다. 설문 요약 화면을 보는 방법은 NAVER WORKS 헬프 센터 > 설문 요약을 참고한다.
  2. 선택한 설문 요약 화면의 URL에서 formId를 확인한다. URL은 https://form.worksmobile.com/forms/{formId}/summary 형식으로 되어 있다.

참고

반복 설문은 formId가 각각 다르므로, 반복 설문 목록 화면에서 formId를 확인하려는 설문을 선택하고 해당 URL에서 formId를 확인한다. 반복 설문 요약 화면을 보는 방법은 NAVER WORKS 헬프 센터 > 반복 설문 요약을 참고한다.