전체 샘플 데이터
### insight : generate
GET https://admin-api-dev.curiai.io/admin/api/v0/insight/generate?survey_uuid=1dc50229-5e50-492f-8077-f8adcc8293df&ver=0
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyaWR4IjoxLCJ1c2Vya2V5IjoiYjNkZDIyZTc0MzdmNjE2MTNjZTNjODAyODIxNDIxYmYiLCJkZXZpY2V0eXBlIjpudWxsLCJwbGF0Zm9ybSI6bnVsbCwibmlja25hbWUiOm51bGwsInBob3RvdXJsIjoiaHR0cHM6Ly9zdG9yYWdlLmdvb2dsZWFwaXMuY29tL3dhbWUtdXBsb2FkL3VzZXIvMjAyNS0wMi0xOC9xczRHTm1iTmhCY2NmZGhzLnBuZyIsInBsYW5fdHlwZSI6ImJhc2ljIiwiaXNfYWN0aXZlIjoxLCJzdGFydF9kYXRlIjoiMjAyNS0wMi0wMVQyMDo0Mjo0My4wMDBaIiwiZW5kX2RhdGUiOiIyMDI1LTAzLTIwVDAzOjQ1OjUwLjAwMFoiLCJwbGFuX2VtYWlsIjoiaGNraW1AZGVhbi5rciIsInBsYW5fcGhvbmUiOiIwMTA4NDQ3MjAyMSIsInBsYW4iOnsiaWRpIjowLCJ0aGVtZSI6MSwiaW5zaWdodCI6MSwidGVhbV9saW1pdCI6MSwidHJhbnNsYXRpb24iOjEsInN1cnZleV9saW1pdCI6NSwicXVlc3Rpb25fdHlwZSI6W10sInF1ZXN0aW9uX2xpbWl0Ijo1MCwib3ZlcnZpZXdfcmVzdWx0IjoxfSwiaWF0IjoxNzQwNDYzMDk5LCJleHAiOjE3NDA1NDk0OTl9.sN9NRR0PJ-H98qG6RClc0Qznfdur8MUuCpNRC0rZHYI
JavaScript
복사
설문조사 결과 API
개요
이 API는 설문조사 응답 데이터를 가공하여 인사이트를 제공합니다.
각 질문 유형에 맞게 데이터를 변환하여 JSON 형태로 반환합니다.
요청 (Request)
GET v0/insight/generate
요청 파라미터
파라미터 | 타입 | 필수 여부 | 설명 |
survey_uuid | string | | 설문조사 UUID |
ver | number | | 설문 버전 |
language | string | | 기본값: ko |
응답 (Response)
응답 구조
{
"msg": "success",
"result": [
{
"question_id": "cplf9llggrssqo0pdhintfpg",
"question_type": "single-choice",
"language": "ko",
"answers": [],
"info": {
"title": "<p>숙소의 주인 아주머니가 외국어를 하는 것이 중요한가요?</p>",
"question_list": [
{
"id": 1,
"value": "1점: 전혀 상관없어요."
},
{
"id": 2,
"value": "2점: 최소한 YES/NO 정도 표현 가능하면 좋겠어요."
},
{
"id": 3,
"value": "3점: 간단한 대화가 가능하면 좋겠어요."
}
]
},
"stats": {
"1": { "total": 7, "value": "1점: 전혀 상관없어요." },
"2": { "total": 11, "value": "2점: 최소한 YES/NO 정도 표현 가능하면 좋겠어요." },
"3": { "total": 19, "value": "3점: 간단한 대화가 가능하면 좋겠어요." }
}
}
]
}
JSON
복사
필드 설명
result[] 배열
각 질문 항목을 포함하는 리스트
필드명 | 타입 | 설명 |
question_id | string | 질문의 고유 ID |
question_type | string | 질문 유형 (예: single-choice, name, email, short-text 등) |
language | string | 언어 코드 (ko, en 등) |
answers | array | 사용자의 응답 (타입별로 다르게 반환됨) |
info | object | 질문의 상세 정보 (제목 및 선택지 목록 포함) |
stats | object | single-choice 타입의 응답 통계 |
answers 필드
질문 유형에 따라 응답 구조가 다름
단일 선택형 (single-choice)
"answers": []
JSON
복사
•
응답은 stats 필드에서 통계로 제공
이름 입력형 (name)
"answers": ["김철수", "박영희"]
JSON
복사
•
사용자가 입력한 이름을 배열로 반환
이메일 입력형 (email)
"answers": ["user1@gmail.com", "user2@naver.com"]
JSON
복사
•
사용자가 입력한 이메일을 배열로 반환
단답형 (short-text)
"answers": ["네이버 검색", "친구 추천"]
JSON
복사
•
사용자가 입력한 텍스트 응답을 배열로 반환
stats 필드
single-choice 타입의 질문에서 선택지별 응답 횟수를 포함
예시
"stats": {
"1": { "total": 7, "value": "1점: 전혀 상관없어요." },
"2": { "total": 11, "value": "2점: 최소한 YES/NO 정도 표현 가능하면 좋겠어요." },
"3": { "total": 19, "value": "3점: 간단한 대화가 가능하면 좋겠어요." }
}
JSON
복사
•
total: 해당 선택지를 선택한 응답자 수
•
value: 선택지 설명
주요 특징
question_type에 따라 응답 데이터가 다르게 처리됨 single-choice 유형의 경우, stats 필드를 통해 응답 통계 제공 name, email, short-text 응답은 배열 형태로 제공