이미지 업로드

이미지형(IMAGE) 템플릿의 본문 이미지와, 아이템리스트형(ITEM_LIST)의 하이라이트 썸네일을 올려요. 규격이 서로 달라서 엔드포인트가 나뉘어 있어요. 카카오 사본은 카카오에 올리기 직전에 서버가 알아서 만들어요.

두 엔드포인트의 차이

1본문 이미지 업로드

요청 파라미터

multipart/form-data 로 보내요.

코드 예제

curl -X POST "https://message.bootapi.com/alimtalk/templates/image" \
  -H "Authorization: Basic {base64(client_key:secret_key)}" \
  -F "image=@/path/to/banner.png"bash

require 'bootpay'

commerce = BootpayStore::RestClient.new(client_key: 'your-commerce-client-key', secret_key: 'your-commerce-secret-key')
response = commerce.alimtalk_template_image(image: '/path/to/banner.png')
puts response.dataruby

파일은 경로 문자열·IO·HTTP::FormData::File 을 모두 받아요.

응답

{
  "image_url": "https://storage.bootpay.co.kr/alimtalk/2026/08/27/banner.png"
}json

돌려받은 image_url 을 템플릿 생성·수정의 storage_image_url 로 넘겨요.

2하이라이트 썸네일 업로드

아이템리스트형의 하이라이트 영역에 들어가는 작은 정사각형 이미지예요.

요청 파라미터

코드 예제

curl -X POST "https://message.bootapi.com/alimtalk/templates/highlight_image" \
  -H "Authorization: Basic {base64(client_key:secret_key)}" \
  -F "image=@/path/to/thumb.png"bash

response = commerce.alimtalk_template_highlight_image(image: '/path/to/thumb.png')
puts response.dataruby

응답

{
  "image_url": "https://storage.bootpay.co.kr/alimtalk/2026/08/27/thumb.png"
}json

이 값은 item_highlight.storage_image_url 로 넘겨요.

이미지 지우기

템플릿 수정에서 storage_image_url 을 빈 값​​으로 보내면 이미지 삭제로 처리되고 카카오에도 반영돼요.

에러 코드