查询黑名单列表（分页）

该接口用于分页查询全部黑名单号码。

GEThttps://dashboard.avavox.com/open/api/v1/phone-blacklists

请求头

Authorization string 必填

• 填写格式：Authorization: Bearer <App Key>
• <App Key> 为控制台「App Key 管理」页面生成的 Key。
• 获取方式详见：《App Key 创建与管理》。

请求参数

pageNum int 可选

页码，从 1 开始，默认 1。

---

pageSize int 可选

每页条数，默认 20，最大 200。

响应数据

code int

状态码，200 为成功，其他状态均为失败。

---

success boolean

是否成功，true 表示成功，false 表示失败。

---

message string

描述信息。

---

data object

点击展开字段说明

total long

总记录数。

---

pageNum int

当前页码。

---

pageSize int

每页条数。

---

pages long

总页数。

---

list array

当前页数据，元素结构：phoneNumber（号码）、reason（加入黑名单原因）、remark（备注）、createTime（加入时间）。

请求示例

curl -X GET --location 'https://dashboard.avavox.com/open/api/v1/phone-blacklists?pageNum=1&pageSize=20' \
--header 'Authorization: Bearer $Key'

响应示例

{
  "code": 200,
  "message": "操作成功",
  "success": true,
  "data": {
    "total": 2,
    "pageNum": 1,
    "pageSize": 20,
    "pages": 1,
    "list": [
      {
        "phoneNumber": "13800000000",
        "reason": "invalid_number",
        "remark": "2026-05 来自工单系统",
        "createTime": "2026-05-29 10:00:00"
      },
      {
        "phoneNumber": "13900000000",
        "reason": "internal_test",
        "remark": "",
        "createTime": "2026-05-29 10:05:00"
      }
    ]
  }
}