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

한눈에 보기

• 국제 메시지 발송 시 clientSubId 필드 신규 추가
• Sender ID / 메시지 서명 복수 관리 지원
• 해외 통신사 정책 대응을 위한 서명 기능 확장
• ApiKey 인증 이용 고객 RateLimit 제어 버그 수정

무엇이 달라졌나요?

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

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

신규 필드

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 정책은 시스템 부하 및 운영 정책에 따라 사전 공지 후 조정될 수 있습니다.