API Reference
브랜드 메시지 이미지 업로드
브랜드 메시지 자유형(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 에 보관하지 않고 공급자로 전달한 뒤 참조만 남깁니다.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/accounts/AC1a2b3c4d/kakao/brand-images" \ -F image="string" \ -F bubbleType="WIDE"{
"id": "cmtn8o4vb000a01s6ykfcak89"
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}