API

발신번호

작성일 2026.03.14 | 수정일 2026.03.14

발신번호 관리 API는 발신번호의 등록, 인증, 상태 관리, 증빙서류 제출, 중복 해제, 개수 제한 해제 등 발신번호의 전체 라이프사이클을 다루는 API입니다.

본인인증(SELF-CERT)을 통해 즉시 활성화하거나, 증빙서류를 제출하여 관리자 승인을 받아 활성화할 수 있습니다. 발신번호에는 유효기간이 있으며, 만료 전 자동 연장 설정이 가능합니다. 발신번호 형식은 8~12자리(숫자)만 가능합니다.

chat

증빙서류 업로드 제한

  • 파일 크기: 최대 10MB

  • 허용 파일 형식: png, gif, jpg, jpeg, pdf, tif, tiff

공통 열거형

status (발신번호 상태)

NameDescription
PENDING대기 중 (증빙서류 심사 대기)
ACTIVE활성화 (사용 가능)
INACTIVE비활성화 (사용자가 일시 중지)
BLOCKED차단됨
DUPLICATED중복 (다른 계정에서 이미 사용 중)
EXPIRED만료됨
DELETED삭제됨
OVERLIMIT개수 제한 초과

method (인증 방법)

NameDescription
SELF-CERT본인인증
DOCUMENT증빙서류 인증
ADMIN관리자 등록

증빙서류 카테고리

NameDescription
SENDERID_APPROVAL통신서비스이용증명원
SENDERID_LIMITATION개수 제한 해제용 서류
SENDERID_IDENTIFICATION신분증/재직증명서
SENDERID_CONSIGNMENT위임 관련 서류

necessaryMeasures (필요 조치)

NameDescription
DUPLICATED중복 해제 요청 필요
OVERLIMIT개수 제한 해제 요청 필요
BUSINESS_DOCUMENTS사업자 증빙서류 제출 필요
CONSIGNMENT_DOCUMENTS위임 관련 서류 제출 필요