Glowb Dev Docs
SaaS API콘텐츠 검수

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/json

Path Parameters

파라미터타입필수설명
applicationIdlong예캠페인 신청 ID

Request Body

{
  "message": "공동작업자 초대는 보냈는데 브랜드 계정에서 아직 수락을 안 했습니다",
  "attachments": ["https://storage.googleapis.com/glowb-input/.../invite.png"]
}
필드타입필수설명
messagestring조건부소명 본문
attachmentsarray조건부첨부 URL 목록. 파일은 기존 업로드 API 로 올린 뒤 URL 만 전달합니다

message 와 attachments 중 최소 하나는 있어야 합니다. 둘 다 비면 400 입니다.

첨부 제한

소명은 캡처 한 장으로 끝나지 않습니다. 초대 화면·상대 계정·대화 내역처럼 여러 장을 붙일 수 있게 배열로 받습니다.

항목값
최대 개수5개
URL 하나당 최대 길이1,000자

빈 문자열·null 은 저장 전에 걸러지고 개수에도 안 들어갑니다.

상한을 넘기면 조용히 자르지 않고 400 으로 거부합니다. 잘린 채 저장되면 JSON 파싱이 깨져 첨부가 통째로 사라지는데, 증거로 낸 캡처가 소리 없이 없어지면 이 기능의 의미가 사라집니다.

동작

  1. 소명 메시지가 스레드에 쌓입니다
  2. 검수 상태가 EXPLAINED(관리자 검토 대기)로 바뀝니다
  3. 슬랙 캠페인 알리미로 운영에 알립니다

반려(REJECTED)된 건에 다시 소명해도 같습니다 — EXPLAINED 로 돌아가 재검토 대기가 됩니다. 반려 사유는 스레드 조회의 rejectionReason 으로 확인하세요.

이미 APPROVED 인 건에 글을 남겨도 통과 상태는 되돌아가지 않습니다.

응답

성공 시 갱신된 스레드 전체를 돌려줍니다. 형식은 소명 스레드 조회 와 같습니다.

에러 응답

상태 코드설명
400본문·첨부가 모두 빔 / 본인 신청 건이 아님 / 최종 제출물 미제출
401인증 실패

API 테스트

On this page