Skip to navigation

050 안심번호 발급

View as Markdown

요금제에 포함된 개수만큼 050 안심번호를 발급합니다. 반납은 DELETE /v1/accounts/{accountId}/numbers/{number} 입니다. 050 안심번호로는 전화를 걸거나 문자를 보낼 수 없습니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

Request

This endpoint expects an object.
forwardTargetslist of stringsOptional

처음 착신 번호(국내 9~11자리, 최대 3개)

Response

발급 성공

numberstring

050 안심번호(11~12자리)

forwardModeenum

착신 방식. carrier_direct = 통신사가 forwardTargets 로 바로 연결합니다.

Allowed values:
forwardTargetslist of strings

착신 번호(국내 9~11자리). 비어 있으면 착신하지 않습니다.

carrierStatusenum

통신사 착신 반영 상태. pending = 반영 대기, active = 반영됨, failed = 반영 실패(자동으로 다시 시도합니다).

Allowed values:

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
409
Conflict Error
503
Service Unavailable Error