Form API로 설문 결과를 조회할 수 있다.
Form API를 호출하려면 구성원 계정으로 인증하여 얻은 Access Token이 필요하다. 서비스 계정으로 인증하여 얻은 Access Token으로는 API를 호출할 수 없다.
API scope는 form, form.read이다.
설문 응답 결과를 조회할 수 있다.
| HTTP Request | Description |
|---|---|
| GET /forms/{formId}/responses | 설문 응답 결과 조회 |
| GET /forms/{formId}/responses/{responseId}/attachments/{attachmentId} | 설문 응답 파일 조회 |
참고
파일 다운로드 방법은 파일 업로드/다운로드를 참고한다.
설문 응답 결과 조회 시 얻을 수 있는 Response는 모두 문자열(String)로 이루어져 있지만, 종류에 따라 형식이 다르다.
| questionType | answer |
|---|---|
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" |
ATTACHMENT | attachmentId. 파일의 취득 방법은 설문 응답 파일 조회를 참고한다. |
Form API는 formId를 사용하여 조회하려는 설문을 지정한다.
formId는 PC 브라우저 버전의 NAVER WORKS 설문 URL에서 확인할 수 있다.
formId를 확인하고 싶은 설문를 선택한다. 설문 요약 화면을 보는 방법은 NAVER WORKS 헬프 센터 > 설문 요약을 참고한다.formId를 확인한다. URL은 https://form.worksmobile.com/forms/{formId}/summary 형식으로 되어 있다.참고
반복 설문은
formId가 각각 다르므로, 반복 설문 목록 화면에서formId를 확인하려는 설문을 선택하고 해당 URL에서formId를 확인한다. 반복 설문 요약 화면을 보는 방법은 NAVER WORKS 헬프 센터 > 반복 설문 요약을 참고한다.