API

증빙서류 업로드

작성일 2026.03.17 | 수정일 2026.03.25

POST/senderid/v1/documents

발신 번호 인증, 개수 증가, 중복 해제 요청에 사용할 증빙서류를 업로드합니다.

Body Params

NameTypeRequiredDescription
filestring*업로드할 파일 (Base64 인코딩). 최대 10MB. 허용 형식: png, gif, jpg, jpeg, pdf, tif, tiff
categorystring*문서 카테고리. SENDERID_APPROVAL, SENDERID_LIMITATION, SENDERID_IDENTIFICATION, SENDERID_CONSIGNMENT 중 하나
namestring문서 이름

Response

NameTypemustDescription
documentIdstring*문서 고유 ID
accountIdstring*계정 고유 ID
namestring문서 이름
urlstring*문서 파일 URL
originalNamestring원본 파일명
categorystring*문서 카테고리
useboolean*사용 여부 (기본값: false)
dateCreatedstring*업로드일시 (ISO 8601)

Structure

Request
{ "file": "data:image/png;base64,iVBORw0KGgoAAAANS...", "category": "SENDERID_APPROVAL", "name": "통신서비스이용증명원" }
Response
{ "accountId": "12345678901234", "limit": 5, "senderIds": [ { "handleKey": "SID_abc123", "phoneNumber": "01012345678", "status": "PENDING", "method": null, "expireAt": null, "autoExtension": true, "necessaryMeasures": [ "BUSINESS_DOCUMENTS" ], "consignment": false, "approvalDocuments": [ { "approvalId": "APR_abc123", "status": "PENDING", "reason": null, "documentList": { "certificateDocument": [ "DOC_abc123" ], "employmentCertificate": "DOC_def456" }, "consignmentDocumentList": null, "dateCreated": "2024-07-01T12:00:00.000Z", "dateUpdated": "2024-07-01T12:00:00.000Z" } ], "unlockDuplicate": null, "dateCreated": "2024-07-01T12:00:00.000Z", "dateUpdated": "2024-07-01T12:00:00.000Z" } ], "limitationDocuments": [], "dateCreated": "2024-01-01T00:00:00.000Z", "dateUpdated": "2024-07-01T12:00:00.000Z" }