API Reference
수신 통화 차단 등록
번호를 수신 통화 차단 목록에 등록합니다. 등록 즉시 그 번호에서 이 계정의 모든 번호로 걸려 오는
수신 통화가 받지 않고 거절됩니다. 거절된 통화는 통화 기록에 status=rejected,
hangupCause=caller_blocked 로 남습니다.
대상은 수신 통화뿐입니다. 이 계정에서 그 번호로 거는 발신은 막지 않습니다 — 발신을 막으려면 수신거부 등록을 사용하세요.
번호 표시제한 통화(발신 번호가 없는 통화)는 이 목록으로 막을 수 없습니다. 번호 설정
(번호 설정 수정)의 rejectCallerIdRestricted 를 켜세요.
멱등입니다. 이미 차단 중인 번호를 다시 등록하면 에러 없이 기존 항목을 200 으로 돌려줍니다.
새로 등록된 경우에만 201 입니다.
차단 중인 항목은 계정당 10,000건까지 등록할 수 있습니다. 넘으면 422 blocked_caller_limit_exceeded 입니다.
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/blocked-callers" \ -H "Content-Type: application/json" \ -d '{ "number": "010-1234-5678" }'{
"id": "clx9bcl00001",
"number": "01012345678",
"active": true,
"source": "api",
"note": "반복 영업 전화",
"createdBy": null,
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"unblockedAt": "2019-08-24T14:15:22Z",
"unblockedSource": "api",
"unblockedBy": "string",
"unblockedNote": "string"
}{
"id": "clx9bcl00001",
"number": "01012345678",
"active": true,
"source": "api",
"note": "반복 영업 전화",
"createdBy": null,
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"unblockedAt": "2019-08-24T14:15:22Z",
"unblockedSource": "api",
"unblockedBy": "string",
"unblockedNote": "string"
}{
"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·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}