안녕하세요. 카카오클라우드입니다.

'Pub/Sub' 서비스 업데이트 작업이 아래와 같이 진행될 예정이오니 서비스 이용에 참고하시기 바랍니다.
 

※ 작업 예정 일시
 - 2026년 09월 22일(화) 19시 00분 ~ 22시 00분

※ 작업 내용

 [ 신규 기능 추가 ]

 1. 서브스크립션 메시지 필터 기능 추가

  • 서브스크립션에서 수신할 메시지를 속성(attributes) 값에 따라 선별할 수 있는 메시지 필터 기능이 추가됩니다.

  • hasKey, hasValue, hasPrefix 함수와 AND, OR, NOT 연산자를 조합해 필터 구문을 설정할 수 있으며, 서브스크립션 모든 유형에서 지원됩니다.

 2. API v2 신규 출시

  • 기존 v1과 기능적으로 동일한 신규 API 버전 v2가 출시됩니다.

  • 신규 연동 시에는 v2 사용을 권장합니다.

  • 기존 v1은 일정 기간 병행 제공되며, 이후 종료(deprecated)됩니다. 종료 일정은 추후 별도 공지될 예정입니다.

 [ 기능 개선 ]

 1. Push 서브스크립션 message header 변경

  • Push 서브스크립션에서 제공되는 message 필드명과 헤더명이 사용자 가이드 기준으로 변경됩니다.

  • 메시지 전송 형식 - 기본 전송 방식

    - AS-IS : body payload 내 message 필드가 message_id, publish_time(snake_case)로 노출

    - TO-BE : 가이드와 동일하게 messageId, publishTime(camelCase)로 노출

  • 메시지 전송 형식 - 메시지 래핑 해제

    - AS-IS : kakaoc-Public-Message-Id, kakaoc-Public-Time, kakaoc-Subscription-Name

    - TO-BE : Kakaoc-Message-Id, Kakaoc-Publish-Time, Kakaoc-Subscription-Name

       (*단, 기존에 내려가던 snake_case(message_id, publish_time) 필드는, deprecated 시점 전까지 camelCase 필드와 함께 제공됩니다.)

 2. attributes의 key, value 제약 사항 개선

  • attributes key

    - AS-IS : 콘솔에서 하이픈(-) 입력 불가

    - TO-BE : API 규격과 동일하게 하이픈(-) 입력 가능하도록 수정

  • attributes value

    - AS-IS : 영문, 숫자, 특수문자만 입력 가능

    - TO-BE : 문자 종류 제한 없이 입력 가능

       (*단, 앞뒤 공백 및 개행 문자는 변경 후에도 입력 불가)

               

※ 서비스 영향 범위
  - 작업 시간 동안 'Pub/Sub' 서비스의 일시적인 API 요청이 순단이 발생할 수 있습니다.

작업 관련 문의 사항은 헬프데스크를 이용해 주십시오.
안전하고 편리한 카카오클라우드를 위해 더욱 노력하겠습니다.

감사합니다.