1. 개정 이력 및 개요

1. 개정 이력

1) Version History

버전	작성일	작성자	설명
1.0	2024-12-30	시스템코어개발팀	초안작성

 

2. 개요

1)   개요

본 문서는 URL 호출 방식으로 네이버 톡톡 발송을 위해 필요한 파트너, 템플릿, 그룹, 이미지의 정보를 관리 할 수 있도록 연동 규격을 정의한 API 문서입니다.

2)   서비스 개요

• 연동 방법은 HTTPS 프로토콜을 사용합니다.
• Request POST 방식만 지원합니다.
• 각 URL Path에 정의된 Parameter를 보내주면 다우기술 서버에서 BL처리 후 결과를 전송해 드리는 방식을 취합니다. (Result : JSON)
• 연동 인코딩은 UTF-8 입니다.
• API 요청에 대한 응답 대기 시간(timeout)은 30초를 권장합니다.

3)   서비스 연동 

• 비즈뿌리오에 등록된 모듈계정(bizId) 이 필요하며 API연동 승인상태임을 확인합니다.
• API를 연동하기 위한 apiKey 발급을 진행해 주세요.
• 연동 URL : https://napi.bizppurio.com/
  1. Rate Limit

4)   Rate Limit 

• Rate Limit 란 특정한 시간 내에 호출할 수 있는 API 요청 횟수를 의미합니다.

• 클라이언트의 API 요청 횟수가 제한 값을 초과하면 HTTP 429 코드를 반환하며 요청이 실패합니다.
• 클라이언트에서 API Rate Limit를 고려해 적절하게 처리하지 않으면 의도하지 않은 오류가 발생할 수 있습니다. 특히, 재시도하는 로직이 있는 경우 재시도 간격을 충분히 늘려 제한 값에 도달하지 않도록 주의해야 합니다.

관리 대상	제어 기준	요청 제한
토큰 API	IP	10r/m
파트너/템플릿 API	계정	100r/m

Response

Headers 

HTTP/1.1 429 Too Many Requests Content-type: application/json X-Rate-Limit-Limit: 100

X-Rate-Limit-Remaining: 95

X-Rate-Limit-Retry-After-Seconds: 3

키	설명
X-Rate-Limit-Limit	기간 시간 내 최대 요청 가능 횟수
X-Rate-Limit-Remaining	기준 시간 내 남은 요청 가능 횟수
X-Rate-Limit-Retry-After- Seconds	기준 시간 갱신까지 남은 시간(s)