브랜드 메시지 이미지 업로드

브랜드 메시지 자유형(Brand.Free)에 실을 이미지를 올리고, 발송에 쓸 id 를 받습니다.

말풍선 유형 대부분이 이미지를 요구합니다. 여기서 받은 id 를 발송 요청의 Brand.Free.imageId 에 그대로 넣으십시오. 한 번 올린 이미지는 여러 발송에 재사용 합니다 — 캠페인마다 다시 올릴 필요가 없습니다.

POST /v1/accounts/{accountId}/kakao/brand-images
  image=@banner.png  bubbleType=WIDE
→ 201 { "id": "cmtn8o4vb000a01s6ykfcak89" }

⚠️ 이미지 규격은 말풍선 유형마다 다릅니다. 유형에 맞지 않는 그림은 이 API 가 아니라 발송할 때 거절될 수 있습니다 — 최종 판정은 카카오가 합니다. bubbleType 을 실제로 보낼 유형과 같게 주십시오.

⚠️ 원본 파일은 ClawOps 에 보관하지 않고 공급자로 전달한 뒤 참조만 남깁니다.

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

accountIdstringRequired

계정 ID

This endpoint expects a multipart form containing a file.

imagefileRequired

최대 5MB의 이미지 파일(jpg, png).

bubbleTypestringRequired

이 이미지를 쓸 말풍선 유형. IMAGE·WIDE·WIDE_ITEM_LIST·CAROUSEL_FEED· COMMERCE·CAROUSEL_COMMERCE. TEXT 는 이미지 자리가 없습니다.

slotstringOptional

이미지가 들어가는 자리. 기본값 main.

WIDE_ITEM_LIST 만 큰 항목(main, 2:1)과 작은 항목(sub, 1:1)의 규격이 갈립니다. 다른 유형은 자리가 하나라 생략하십시오.

업로드 완료

idstring

400

Bad Request Error

401

Unauthorized Error