API Reference
증명서 조회
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
certificateNumber*string
발급번호(문서에 찍힌 번호)
Match
^KAT-[0-9]{8}-[0-9]{4,}$Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/accounts/AC1a2b3c4d/certificates/KAT-20261016-0001"{
"certificateNumber": "KAT-20261016-0001",
"type": "telecom_subscription",
"title": "통신서비스 이용증명원",
"holder": {
"type": "business",
"name": "주식회사 예시",
"registrationNumber": "123-45-67890",
"birthDate": "1980-**-**"
},
"subject": {
"number": "07012340001",
"numberType": "internet_phone",
"subscriptionDate": "2026-08-14"
},
"issueDate": "2026-10-16",
"status": "issued",
"revokedAt": null,
"revokedReason": null,
"pdfSha256": "3b5f0c1e9a7d4b2e8f6a1c0d9e8b7a6f5e4d3c2b1a0f9e8d7c6b5a4f3e2d1c0b",
"pdfPath": "/v1/accounts/AC1a2b3c4d/certificates/KAT-20261016-0001/pdf",
"createdAt": "2026-10-16T01:02:03.000Z"
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}