API Guide

변경 로그 ​

날짜별로 수정된 사항에 대해 안내드립니다.

2026-09-11 ​

오류 코드 안내 — 실패 사유를 코드로 구분하실 수 있습니다.

  • 응답에 errorCode 필드가 추가됐습니다. 사유를 특정할 수 있는 실패에 실립니다.
  • 문자·알림톡·브랜드 메시지·발신 프로필 문서에 오류 코드 절을 넣었습니다. 성공 여부 판정 방법과 API 별 사유 코드 표가 들어 있습니다.

문서 구성 변경

  • 알림톡 발송을 문자 발송 문서에서 알림톡 API 문서로 옮겼습니다. 템플릿 등록·수정과 같은 페이지에서 보실 수 있습니다.
  • 왼쪽 목록의 Kakao Alimtalk Template API 를 Kakao Alimtalk API 로 바꿨습니다. 이제 발송까지 함께 다룹니다.
  • 각 문서 위에 있던 권장 버전 안내를 뺐습니다. 지금 보고 계신 버전은 헤더의 버전 메뉴에서 확인하고 바꾸실 수 있습니다.

2026-09-10 ​

가이드 버전 분기 — 헤더에서 버전을 고를 수 있습니다.

  • 문서 버전별로 가이드를 확인하실 수 있게 버전을 분기하였습니다. 주소가 버전별로 갈립니다 — /ice/guide/api/v1.1/..., /ice/guide/api/v1.0/...
  • 브랜드 메시지 문서에서 actions 와 carousel.list[].buttons 가 코드가 아닌 글자로 보이던 표기 오류가 수정됐습니다.
  • 알림톡 템플릿 API 에서 브랜드 메시지 문서로 가는 "다음 페이지" 링크가 빠져 있던 것을 채웠습니다.

문서 보강

  • API 도메인 예시에 대괄호와 괄호가 그대로 보이던 표기 오류가 수정됐습니다. (발신프로필 API, 알림톡 템플릿 API)
  • 각 페이지 아래에 최종 수정일을 표시합니다.

2026-09-08 ​

  • 알림톡 템플릿 API — 이미지 URL 수신과 섬네일 1:1 비율 제약이 반영됐습니다. (문서 정정)

2026-09-03 ​

  • 이메일 발송 API 문서가 추가됐습니다.

2026-09-01 ​

  • 브랜드 메시지 — 최상위 resendParameter 와 coupon 은 요청 시점에 거절됩니다. (문서 정정)

2026-08-31 ​

  • 메시지 Open API 3종을 실제 구현에 맞춰 정정하고 빠져 있던 제약을 채웠습니다. (문서 정정)
  • 공통 응답의 time 타입과 조회 필터 동작이 수정됐습니다. (문서 정정)
  • messageProductType이 확정되지 않은 건은 발송 유형이 그대로 표시됩니다. (문서 정정)
  • 브랜드 메시지 — 이미지 계약을 imageUrl 수용에 맞춰 되돌렸습니다. (문서 정정)
  • 알림톡 템플릿 — 아이템 리스트 폼이 추가됐습니다.

2026-08-24 ​

  • 문서 예시에 쓰는 API 도메인이 갱신됐습니다.

2026-08-12 ​

  • 브랜드 메시지 API 문서가 추가됐습니다. v1.1 부터 지원합니다.
  • API 도메인 표기가 신규 플랫폼 기준으로 갱신됐습니다.

2026-08-11 ​

  • 메시징 Open API 가이드가 신규 플랫폼으로 이관됐고 엔드포인트의 v1.1 표기가 반영됐습니다.

최근 수정일: