API 레퍼런스
조직의 피드백을 조회하고 프로젝트 키로 전송하는 경계를 설명합니다.
피드백 목록 조회에는 admin:read 또는 feedback:read가 필요합니다.
curl -sS https://crm.theseeker.io/api/v1/feedback \
-H "Authorization: Bearer $THESEEKER_API_KEY"응답은 인증 키가 허용하는 조직 또는 프로젝트 범위 안에서 반환됩니다.
피드백 전송은 프로젝트 ingest 경로를 사용합니다. Status SDK에서는 sendFeedback으로 호출합니다.
await status.sendFeedback({
uid: "user-123",
content: "검색 결과가 느립니다.",
fields: { plan: "pro" },
});이 요청에는 프로젝트 키와 SDK가 생성하는 서명 헤더가 필요합니다. 관리 API Bearer 키를 ingest HMAC 키 대신 사용하지 마세요.
필드 | 설명 |
|---|---|
| 호출자가 정한 사용자 식별자 |
| 피드백 본문 |
| 검색 가능한 추가 필드 |
| 부가 문맥 |
GET /api/v1/feedback은 feedbacks 배열과 페이지네이션용 nextCursor를 반환합니다. 각 항목은 기존 ID, 사용자 ID, 본문, 발생·수신 시각, fields, extra에 다음 필드를 추가로 포함합니다.
필드 | 형식 | 설명 |
|---|---|---|
| string |
|
| string[] | 피드백 분류 태그 |
| string |
|
| string |
|
| number 또는 null | NPS/CSAT 점수 |
| string 또는 null | 응답 페이지 URL |
| string 또는 null | 제출자가 제공한 연락 이메일 |
| string 또는 null | 연결된 분석 세션 |
| string 또는 null | 연결된 분석 프로퍼티 |
| string[] | 연결된 에러 이슈 ID |
| string 또는 null | 방문자 환경 정보 |
| boolean | 스크린샷 첨부 존재 여부 |
| ISO 시각 또는 null | 마지막 갱신 시각 |
공개 위젯은 POST /api/feedback/widget로 JSON을 전송합니다. config는 GET /api/feedback/widget/config?key=fbw_…로 조회합니다. 허용 도메인에서 온 Origin이 필요합니다. 설정과 제출의 CORS 응답은 허용 Origin에 한하며, preflight는 POST, OPTIONS와 Content-Type을 허용합니다.
본문에는 key, kind, content, pageUrl을 보내고 선택적으로 contactEmail, uid, JPEG data URL screenshot, surveyId, score를 포함합니다. 일반 피드백 본문은 15,000자이며 설문은 05,000자입니다. NPS 점수는 010, CSAT은 15입니다. 요청 최대 크기는 2 MiB이며, 스크린샷은 JPEG 시그니처와 최대 1,572,864바이트를 요구합니다. IP/key 조합당 10분 10회, key당 10분 100회로 제한됩니다. 성공 시 201 {"id":"…"}를 반환합니다. 설문 제출은 현재 활성 설문 ID와 유형이 일치해야 합니다.
조회 인증 실패는 401, scope 부족은 403, 잘못된 요청은 400입니다.
secret과 개인정보가 서버 로그나 피드백 본문에 섞이지 않도록 호출 전에 정제하세요.
이 페이지가 도움이 되었나요?