전화번호

050 안심번호 발급

Markdown으로 보기
POST
/v1/accounts/{accountId}/safety-numbers

050 안심번호를 한 개 발급합니다. 번호는 재고에서 배정되며 직접 고를 수 없습니다.

요금 번호당 월 1,000원(부가세 포함)이며, 발급받은 날부터 반납한 날까지 보유한 기간만큼 일할로 청구됩니다. 발급할 수 있는 개수에 제한은 없습니다. 050 번호로 걸려 온 통화의 수신 통화료는 없습니다. 통신사가 아닌 우리 시스템을 거쳐 내 070·대표번호로 전환되는 통화(콘솔의 「내 번호로 연결」)는 전환받는 번호의 수신 요금이 적용됩니다.

사용 조건 개인 또는 비즈니스 요금제의 활성 구독이 필요합니다(체험 요금제는 받을 수 없습니다).

반납 DELETE /v1/accounts/{accountId}/numbers/{number} 입니다. 반납하면 청구가 멈추고 통신사 착신이 해지되며, 같은 번호를 다시 받을 수 있다고 보장하지 않습니다. 050 안심번호로는 전화를 걸거나 문자를 보낼 수 없습니다.

Authorization

BearerAuth
AuthorizationBearer <token>

API Key를 Bearer 토큰으로 전달

In: header

Path Parameters

accountId*string

계정 ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/accounts/AC1a2b3c4d/safety-numbers" \  -H "Content-Type: application/json" \  -d '{}'
{
  "number": "050412345678",
  "forwardMode": "carrier_direct",
  "forwardTargets": [
    "01012345678"
  ],
  "carrierStatus": "pending"
}
{
  "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"
  ]
}
{
  "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"
  ]
}