Skip to navigation

문자 발신번호 등록

View as Markdown

이 계정이 ClawOps에서 개통한 070번호·대표번호를 문자 발신번호로 등록합니다. 등록 즉시 승인되어 발송에 쓸 수 있습니다. 한 번에 한 번호씩 등록합니다.

이미 등록된 번호면 409 sender_number_already_registered 를 돌려줍니다. 이 경우 번호는 이미 발송에 쓸 수 있는 상태입니다.

발신번호 범위를 지정한 API 키로는 등록할 수 없습니다(403 api_key_sender_numbers_restricted).

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

Request

This endpoint expects an object.
numberstringRequired

등록할 번호. 하이픈·+82 국가번호 표기도 받습니다.

Response

등록됨

idstring

발신번호 id. 삭제할 때 씁니다.

numberstring

발신번호(숫자만)

typeenum

번호 유형. representative=대표번호, mobile=이동전화

Allowed values:
verificationMethodenum

등록할 때 거친 확인 방법. own_provisioned=ClawOps에서 개통한 번호, identity_verified=본인확인한 이동전화번호, usage_cert_ars=다른 통신사업자 대표번호(이용증명원·ARS 심사)

Allowed values:
statusenum

approved=발송에 쓸 수 있음, pending=승인 대기

Allowed values:
createdAtdatetime

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error