수신거부 목록 조회

GET

https://api.claw-ops.com/v1/accounts/:accountId/blocked-recipients

GET

/v1/accounts/:accountId/blocked-recipients

curl -G https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/blocked-recipients \
     -H "Authorization: Bearer <token>" \
     -d channel=call \
     -d limit=100 \
     -d page=0 \
     -d pageSize=20 \
     -d page_size=50 \
     -d recipient=010-1234-5678 \
     -d status=active

{
  "data": [
    {
      "id": "clx9blk00001",
      "recipient": "01012345678",
      "channel": "call",
      "active": true,
      "source": "api",
      "sourceRef": "CA1a2b3c4d5e",
      "note": "상담 중 재연락 거부 의사 밝힘",
      "createdBy": null,
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z",
      "unblockedAt": "2024-01-15T09:30:00Z",
      "unblockedSource": "api",
      "unblockedBy": "string",
      "unblockedNote": "string"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 1,
    "total": 1
  }
}

계정의 수신거부(DNC) 명단을 조회합니다. 기본은 현재 차단 중인 항목만 반환하며, 해제된 이력까지 보려면 status 를 released 또는 all 로 지정합니다.

같은 상대라도 채널(call/message/email)마다 별개 항목이므로, 전화와 문자를 모두 거부한 번호는 2건으로 나타납니다.

대상은 채널과 무관하게 recipient 에 담깁니다 — call·message 면 전화번호, email 이면 이메일 주소입니다.

recipient 필터는 채널에 맞춰 정규화 후 대조하므로 010-1234-5678 로도 Kim@Example.com 으로도 검색됩니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

Query parameters

channelenumOptional

채널 필터. 미지정 시 전체.

Allowed values:

recipientstringOptional

대상 필터(정확 일치). 채널에 맞춰 정규화 후 대조하므로 하이픈·+82 표기로도, 대문자 섞인 이메일로도 찾힙니다. channel 을 함께 주지 않으면 입력 모양으로 가릅니다.

statusenumOptionalDefaults to active

active=차단 중(기본), released=해제된 이력, all=전체

Allowed values:

pageintegerOptionalDefaults to 0

페이지 번호(0-based)

pageSizeintegerOptional<=100Defaults to 20

페이지 크기(최대 100)

page_sizeintegerOptional<=100Deprecated

pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.

limitintegerOptional<=100Deprecated

pageSize 의 별칭(하위호환). 신규 연동은 pageSize 를 사용하세요.

Response

수신거부 목록

datalist of objectsOptional

수신거부 항목 목록. 최근 접수순.

metaobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error