[ 26.01.31 ] 1월 API 업데이트 월간 요약

한눈에 보기

• 국제 메시지 발송 시 clientSubId 필드 신규 추가

• Sender ID / 메시지 서명 복수 관리 지원

• 해외 통신사 정책 대응을 위한 서명 기능 확장

• ApiKey 인증 이용 고객 RateLimit 제어 버그 수정

---

무엇이 달라졌나요?

1. 국제 메시지 발송 서명 기능 확장

국제 메시지 발송 시 Sender ID 및 메시지 서명을 복수로 관리할 수 있도록 신규 필드 clientSubId가 추가되었습니다.

신규 필드

필드명	설명
clientSubId	Sender ID / 메시지 서명을 구분하기 위한 식별자
최대 길이	20 byte

Sender ID란?

Sender ID는 메시지를 수신하는 단말기에서 “보내는 사람” 영역에 표시되는 발신자 정보입니다.

• 일부 해외 국가/통신사는 숫자(15882460)뿐 아니라 문자열(Korea, MyService) Sender ID를 허용합니다.

• 스팸·사칭 방지를 위해 기업 또는 서비스 고유 Sender ID를 사전 등록해야 하는 국가도 있습니다.

• 대표 국가: 인도네시아, 인도, 필리핀, 태국 등

• Sender ID 등록에는 통상 2~4주가 소요됩니다.

메시지 서명이란?

해외 메시지 발송 시, 메시지 본문에 발송 주체(회사명·서비스명)를 식별할 수 있는 문자열을 필수로 삽입해야 하는 정책이 존재합니다.

• 이를 메시지 서명이라 하며, 사전 등록이 필요합니다.

• 대표 국가: 중국

• 예시 형태:

  【INFO中国】메시지 내용

clientSubId를 통해 Sender ID + 메시지 서명 조합을 복수로 관리할 수 있어 국가·서비스별 국제 발송 대응이 한층 유연해졌습니다.

---

2. ApiKey인증 이용 고객 RateLimit 제어 버그 개선

ApiKey 기반으로 유입되는 일부 고객에게 RateLimit이 Default 값으로만 적용되던 버그가 수정되었습니다.

• 고객별 설정된 RateLimit 정책이 정상적으로 적용되도록 개선

• 고트래픽 고객 환경에서도 호출 제어의 정합성이 보장됩니다

---

왜 중요한가요? (1줄씩 풀어서 설명)

• 국제 메시지 서명 기능 확장은 국가·통신사별 상이한 정책을 유연하게 대응할 수 있어 글로벌 메시지 발송 안정성을 높여줍니다.

• clientSubId 도입은 하나의 API Key로 여러 Sender ID와 서명을 관리할 수 있게 해 국제 서비스 운영 복잡도를 낮춰줍니다.

• ApiKey 인증 RateLimit 버그 수정은 고객별 호출 정책이 정확히 적용되도록 해 대량 트래픽 환경에서도 예측 가능한 API 운영을 가능하게 합니다.

---

이렇게 사용하세요

• 국제 메시지 발송 시, Sender ID / 메시지 서명 단위로 clientSubId를 분리해 설정하는 것을 권장합니다.

• Sender ID 또는 메시지 서명이 필요한 국가는 **사전 등록 기간(2~4주)**을 고려해 운영 일정을 계획해 주세요.

• ApiKey 인증이용 고객은 별도 설정 변경 없이도 RateLimit 정책이 자동으로 정상 적용됩니다.

---

유의사항

• Sender ID 및 메시지 서명 정책은 국가·통신사별로 상이하며, 사전 등록 없이 발송 시 실패할 수 있습니다.

• 메시지 서명 미삽입 또는 잘못된 Sender ID 사용 시 스팸 또는 사칭 메시지로 차단될 수 있습니다.

• 국제 메시지 정책 관련 상세 사항은 영업 담당자를 통해 별도 확인이 필요합니다.

• RateLimit 정책은 시스템 부하 및 운영 정책에 따라 사전 공지 후 조정될 수 있습니다.