POST /ai/influence/contents/{applicationId}/final-submission/explanations
최종 제출물 소명 등록 (크리에이터)
최종 제출물 소명 등록 (크리에이터)
게시 필수 항목 중에는 크리에이터 혼자 통과시킬 수 없는 것이 있습니다. 인스타그램 공동작업자는 크리에이터가 초대해도 브랜드 계정이 수락해야 게시물에 반영되고, Instagram API 는 수락이 끝난 공동작업자만 노출합니다. 그래서 "초대를 안 한 것"과 "초대했는데 수락이 안 된 것"이 자동 검수에는 똑같이 보입니다.
이 API 는 그 간극을 크리에이터가 설명할 수 있는 통로입니다. 초대 화면 캡처 등을 올리면 관리자가 확인 후 검수를 풀어줍니다.
소명은 재제출이 아닙니다.
submittedAt을 갱신하지 않습니다- 자동 검수가 다시 예약되지 않습니다
- 재제출 마감이 밀리지 않고, 캠페인 지연 사유도 붙지 않습니다
게시물을 실제로 고쳤다면 소명이 아니라 재제출(PATCH /ai/influence/contents/{applicationId}/final-submission)을 쓰세요.
HTTP 요청
POST /ai/influence/contents/{applicationId}/final-submission/explanations
Authorization: Bearer {access_token}
Content-Type: application/jsonPath Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
applicationId | long | 예 | 캠페인 신청 ID |
Request Body
{
"message": "공동작업자 초대는 보냈는데 브랜드 계정에서 아직 수락을 안 했습니다",
"attachments": ["https://storage.googleapis.com/glowb-input/.../invite.png"]
}| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
message | string | 조건부 | 소명 본문 |
attachments | array | 조건부 | 첨부 URL 목록. 파일은 기존 업로드 API 로 올린 뒤 URL 만 전달합니다 |
message 와 attachments 중 최소 하나는 있어야 합니다. 둘 다 비면 400 입니다.
첨부 제한
소명은 캡처 한 장으로 끝나지 않습니다. 초대 화면·상대 계정·대화 내역처럼 여러 장을 붙일 수 있게 배열로 받습니다.
| 항목 | 값 |
|---|---|
| 최대 개수 | 5개 |
| URL 하나당 최대 길이 | 1,000자 |
빈 문자열·null 은 저장 전에 걸러지고 개수에도 안 들어갑니다.
상한을 넘기면 조용히 자르지 않고 400 으로 거부합니다. 잘린 채 저장되면 JSON 파싱이 깨져 첨부가 통째로 사라지는데, 증거로 낸 캡처가 소리 없이 없어지면 이 기능의 의미가 사라집니다.
동작
- 소명 메시지가 스레드에 쌓입니다
- 검수 상태가
EXPLAINED(관리자 검토 대기)로 바뀝니다 - 슬랙 캠페인 알리미로 운영에 알립니다
반려(REJECTED)된 건에 다시 소명해도 같습니다 — EXPLAINED 로 돌아가 재검토 대기가 됩니다.
반려 사유는 스레드 조회의 rejectionReason 으로 확인하세요.
이미 APPROVED 인 건에 글을 남겨도 통과 상태는 되돌아가지 않습니다.
응답
성공 시 갱신된 스레드 전체를 돌려줍니다. 형식은 소명 스레드 조회 와 같습니다.
에러 응답
| 상태 코드 | 설명 |
|---|---|
400 | 본문·첨부가 모두 빔 / 본인 신청 건이 아님 / 최종 제출물 미제출 |
401 | 인증 실패 |