API Reference
수신 통화 차단 목록 조회
계정의 수신 통화 차단 목록을 조회합니다. 기본은 현재 차단 중인 항목만 반환하며,
해제된 이력까지 보려면 status 를 released 또는 all 로 지정합니다.
number 필터는 정규화 후 대조하므로 010-1234-5678 로도 검색됩니다.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
Query Parameters
number?string
번호 필터(정확 일치). 정규화 후 대조하므로 하이픈·+82 표기로도 찾힙니다.
status?string
active=차단 중(기본), released=해제된 이력, all=전체
Default
"active"Value in
"active" | "released" | "all"page?integer
페이지 번호(0-based)
Default
0pageSize?integer
페이지 크기(최대 100)
Default
20Range
value <= 100page_size?integerDeprecated
pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.
Range
value <= 100limit?integerDeprecated
pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.
Range
value <= 100Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/accounts/AC1a2b3c4d/blocked-callers?number=010-1234-5678&status=active&page=0&pageSize=20&page_size=50&limit=100"{
"data": [
{
"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"
}
],
"meta": {
"page": 0,
"pageSize": 0,
"total": 0
}
}{
"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·대표번호만 발급됩니다."
}
]
}