발신표기번호 등록 신청

curl --request POST \ --url https://client-api.tryvox.co/v3/telephone-presentation-numbers \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: multipart/form-data' \ --form 'number=<string>' \ --form document='@example-file' \ --form 'memo=<string>'

{ "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "number": "<string>", "status": "<string>", "sms_send_capable": true, "created_at": 123, "memo": "<string>", "submitted_at": 123 }

Authorizations

Authorization

string

header

required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Body

multipart/form-data

이 엔드포인트가 받는 multipart 폼 데이터입니다.

number

string

required

등록할 발신표기번호입니다. 하이픈이나 공백을 포함해도 서버가 숫자만 남겨 정규화합니다. 010 휴대폰 번호는 등록할 수 없습니다.

document

file

required

통신가입증명원 파일입니다. JPEG, PNG, WebP, PDF 형식에 10 MB 이하여야 합니다.

memo

string | null

발신표기번호에 대한 메모입니다. 최대 64자입니다.

Maximum string length: 64

Response

성공 응답

발신표기번호 응답입니다.

string<uuid>

required

발신표기번호 레코드의 고유 식별자입니다.

organization_id

string<uuid>

required

발신표기번호를 등록한 조직 ID입니다.

number

string

required

발신표기번호입니다. 하이픈 없는 숫자 문자열로 반환됩니다.

status

string

required

발신표기번호 등록 상태입니다. pending, approved, rejected 중 하나입니다.

sms_send_capable

boolean

required

이 발신표기번호로 SMS 발신이 가능한지를 나타냅니다.

created_at

integer

required

리소스 생성 시각입니다. unix milliseconds 형식입니다.

memo

string | null

발신표기번호에 대한 메모입니다. 설정되지 않았으면 null입니다.

submitted_at

integer | null

등록 신청이 접수된 일시입니다. unix timestamp (ms).