This page is generated from the public contract. Descriptions are shown in the original Korean.
인증한 User·Agent의 피드백 접수. 열람·관리는 Back Office 후속 범위입니다.
VoC 접수#
POST /api/feedback
인증 결과에서 Organization·제출자를 결정합니다. 후보 상세·목록·조회는 제공하지 않습니다. 재전송 키는 24시간, 동일 유형·정규화 제목·본문의 반복 차단은 10분입니다. 같은 Organization·제출자당 1시간에 신규 10건. 재전송·중복 오류는 한도를 사용하지 않습니다. 키 충돌→반복 차단→rate limit 순으로 판정하며 유사 후보는 접수를 막지 않습니다.
Authentication: Session cookie or Agent token
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Idempotency-Key | header | string | Yes | 제출마다 생성한 키. 재전송은 같은 키와 내용을 사용합니다. |
Request body
application/json · Required: Yes
Type: Feedback.Submission
| Name | Type | Required | Description |
|---|---|---|---|
channel | string | Yes | Values: web, cli |
feedback_type | string | Yes | Values: bug, usability, feature-request, workflow-improvement, documentation, performance, other |
message | string | Yes | |
metadata | object | No | 선택 맥락. JSON 직렬화 기준 8 KiB 이하. 비밀정보를 포함하지 마세요. |
product_version | string | No | |
source | string | Yes | Values: user, ai-agent |
title | string | Yes |
Responses
| Status | Description |
|---|---|
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 response body
Type: Feedback.Receipt
| Name | Type | Required | Description |
|---|---|---|---|
has_duplicate_candidates | boolean | Yes | |
id | string | Yes |