표시 번호 등록 신청

POST

https://api.claw-ops.com/v1/accounts/:accountId/presentation-numbers

직접 보유한 유선번호·대표번호를 표시 번호로 신청합니다. 콘솔 신청과 같은 규칙이 적용되고, 한국AI통신의 심사를 거칩니다. 결과는 조회와 메일로 확인합니다.

통신가입증명원은 발급 1개월 이내여야 합니다. 증명원 명의가 계정 명의와 다르면 위임장, 인감증명서, 재직 증빙도 함께 냅니다. 계정 구성원에게 신청 알림 메일이 갑니다.

발신번호 범위를 지정한 API 키와 발급자를 확인할 수 없는 API 키로는 신청할 수 없습니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

Request

This endpoint expects an object.

numberstringRequired

표시할 유선번호 또는 대표번호

documentslist of objectsRequired

제출 서류. 같은 종류의 파일을 여러 개 낼 수 있습니다.

Response

신청 접수

idstring

표시 번호 id. 070 번호에 걸 때 presentationNumberId 로 씁니다.

numberstring

표시 번호(숫자만)

typeenum

번호 유형. landline=유선번호, representative=대표번호

Allowed values:

verificationMethodenum

등록할 때 거친 확인 방법. own_provisioned=한국AI통신에서 개통한 번호, usage_cert=통신가입증명원 심사, usage_cert_ars=통신가입증명원 심사와 ARS

Allowed values:

statusenum

pending=심사 중, approved=승인, rejected=반려

Allowed values:

rejectedReasonstring or null

반려 사유. 반려되지 않았으면 null 입니다.

phoneNumberslist of strings

이 표시 번호를 걸어 둔 번호

createdAtdatetime

updatedAtdatetime

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error