기타

관리번호 발신번호 표기 신청 링크 목록

Markdown으로 보기
GET
/v1/accounts/{accountId}/numbers/{number}/presentation-links

이 관리번호의 지금 명의 링크만 돌려줍니다. 관리번호가 아니면 빈 목록입니다.

Authorization

BearerAuth
AuthorizationBearer <token>

API Key를 Bearer 토큰으로 전달

In: header

Path Parameters

accountId*string

계정 ID

number*string

관리번호

Query Parameters

status?string

링크 상태로 거르기

Value in"pending" | "submitted" | "approved" | "rejected" | "removed" | "revoked" | "expired"
pageSize?integer

페이지 크기

Default50
page?integer

페이지 번호

Default0

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/accounts/AC1a2b3c4d/numbers/07012345678/presentation-links?status=pending&pageSize=50&page=0"
{
  "data": [
    {
      "id": "string",
      "url": "string",
      "number": "string",
      "status": "pending",
      "presentationNumber": "string",
      "presentationNumberId": "string",
      "rejectedReason": "string",
      "note": "string",
      "returnUrl": "string",
      "expiresAt": "2019-08-24T14:15:22Z",
      "createdAt": "2019-08-24T14:15:22Z"
    }
  ],
  "meta": {
    "page": 0,
    "pageSize": 0,
    "total": 0
  }
}
{
  "error": "string",
  "code": "recipient_blocked",
  "ip": "52.79.213.41",
  "processedAt": "2026-10-21T04:10:34.303Z",
  "blockers": [
    {
      "number": "07012340002",
      "code": "number_not_carrier_issued",
      "message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
    }
  ],
  "numbers": [
    "07012345678"
  ]
}
{
  "error": "string",
  "code": "recipient_blocked",
  "ip": "52.79.213.41",
  "processedAt": "2026-10-21T04:10:34.303Z",
  "blockers": [
    {
      "number": "07012340002",
      "code": "number_not_carrier_issued",
      "message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
    }
  ],
  "numbers": [
    "07012345678"
  ]
}
{
  "error": "string",
  "code": "recipient_blocked",
  "ip": "52.79.213.41",
  "processedAt": "2026-10-21T04:10:34.303Z",
  "blockers": [
    {
      "number": "07012340002",
      "code": "number_not_carrier_issued",
      "message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
    }
  ],
  "numbers": [
    "07012345678"
  ]
}