피드백 번역

기업이 작성한 피드백 문구를 캠페인의 크리에이터 국가 언어(한국어·일본어·영어)로 번역합니다. 저장 전에 번역본을 미리 보여 주거나, 원문과 번역본을 함께 저장할 때 사용합니다.

번역 대상 언어는 요청에 담지 않고 서버가 캠페인(collabNo)의 크리에이터 타겟 국가로 결정합니다. 응답의 language는 ko / jp / en 중 하나입니다. ko면 번역하지 않으므로 translations는 null입니다.

호출 가능 대상: 기업, 에이전시 고객사, 상위 에이전시(자기 고객사 캠페인), 어드민. 기업·에이전시 고객사는 자기 캠페인(또는 에이전시 접근 권한이 있는 캠페인)만 번역할 수 있고, 어드민은 모든 캠페인이 가능합니다. 크리에이터 계정은 호출할 수 없으며 요청 시 CAMPAIGN_NOT_OWNED(403)가 발생합니다.

HTTP 요청

POST /ai/v4/feedback/translate
Authorization: Bearer {access_token}
Content-Type: application/json

Request Body

{
  "collabNo": 1234,
  "texts": [
    "자막의 과장 표현을 수정해 주세요.",
    "제품 노출 시간을 3초 이상으로 늘려 주세요."
  ]
}

필드명	타입	필수	설명
`collabNo`	`Integer`	예	캠페인 번호
`texts`	`string[]`	예	번역할 문구. 1~50건, 건당 5,000자 이하, 합계 30,000자 이하이며 빈 문자열·`null` 불가

응답

성공 응답 (200 OK) - 번역됨

translations는 요청한 texts와 같은 순서·같은 개수입니다.

{
  "status": 200,
  "code": null,
  "message": "피드백 번역이 완료되었습니다.",
  "data": {
    "language": "en",
    "translations": [
      "Please fix the exaggerated expression in the subtitles.",
      "Please extend the product exposure time to at least 3 seconds."
    ]
  }
}

성공 응답 (200 OK) - 한국어 캠페인

{
  "status": 200,
  "code": null,
  "message": "피드백 번역이 완료되었습니다.",
  "data": {
    "language": "ko",
    "translations": null
  }
}

에러 응답

에러는 HTTP 200으로 내려오고 본문의 status/code로 구분합니다.

`status`	`code`	설명
`400`	`FEEDBACK_TRANSLATION_INVALID_REQUEST`	`collabNo`/`texts` 누락, 1~50건 범위 초과, 빈 문구, 건당 5,000자 초과, 합계 30,000자 초과
`403`	`CAMPAIGN_NOT_OWNED`	해당 캠페인에 접근 권한이 없음
`404`	`CAMPAIGN_NOT_FOUND`	캠페인을 찾을 수 없음
`503`	`FEEDBACK_TRANSLATION_FAILED`	번역 서비스 호출 실패 또는 응답 건수 불일치. 잠시 후 재시도하거나 원문으로 저장
`401`	-	인증 실패

POST /ai/v4/feedback/translate