이 페이지는 공개 계약에서 생성하며 설명은 원문(한국어) 그대로 표시합니다.
인증한 User·Agent의 피드백 접수. 열람·관리는 Back Office 후속 범위입니다.
VoC 접수#
POST /api/feedback
인증 결과에서 Organization·제출자를 결정합니다. 후보 상세·목록·조회는 제공하지 않습니다. 재전송 키는 24시간, 동일 유형·정규화 제목·본문의 반복 차단은 10분입니다. 같은 Organization·제출자당 1시간에 신규 10건. 재전송·중복 오류는 한도를 사용하지 않습니다. 키 충돌→반복 차단→rate limit 순으로 판정하며 유사 후보는 접수를 막지 않습니다.
인증: 세션 쿠키 또는 Agent 토큰
Parameter
| 이름 | 위치 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
Idempotency-Key | header | string | 예 | 제출마다 생성한 키. 재전송은 같은 키와 내용을 사용합니다. |
요청 본문
application/json · 필수: 예
타입: Feedback.Submission
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
channel | string | 예 | 값: web, cli |
feedback_type | string | 예 | 값: bug, usability, feature-request, workflow-improvement, documentation, performance, other |
message | string | 예 | |
metadata | object | 아니요 | 선택 맥락. JSON 직렬화 기준 8 KiB 이하. 비밀정보를 포함하지 마세요. |
product_version | string | 아니요 | |
source | string | 예 | 값: user, ai-agent |
title | string | 예 |
응답
| 상태 | 설명 |
|---|---|
200 | 동일 키·내용의 재전송. 기존 접수 ID 반환 |
201 | 새 접수 완료 |
400 | INVALID_REQUEST: 키 누락·형식 오류, 닫힌 필드, 중복 JSON 키, query 거부 |
401 | UNAUTHENTICATED |
403 | FORBIDDEN_ORIGIN 또는 ORGANIZATION_UNVERIFIED |
409 | ORGANIZATION_REQUIRED, FEEDBACK_IDEMPOTENCY_CONFLICT 또는 FEEDBACK_DUPLICATE. DUPLICATE만 본인의 기존 receipt 포함 |
413 | PAYLOAD_TOO_LARGE: 64 KiB 초과 |
415 | UNSUPPORTED_MEDIA_TYPE |
422 | VALIDATION_FAILED |
429 | FEEDBACK_RATE_LIMITED |
500 | INTERNAL_ERROR: 같은 키·내용으로 결과를 다시 확인 |
200 응답 본문
타입: Feedback.Receipt
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
has_duplicate_candidates | boolean | 예 | |
id | string | 예 |