查询手机号黑名单
更新时间：2023-08-05
URL
/sms/v3/blacklist
HTTP Method
GET
请求Query参数
| 参数名称 | 类型 | 是否必需 | 描述 | 取值示例 |
|---|---|---|---|---|
| phone | String | 否 | 加黑手机号。支持多个，多个手机号之间要用英文逗号隔开，一次请求最多200个，手机号格式为标准11位国内手机号 | 13800000000,13800000001,13800000002 |
| smsType | String | 否 | 短信类型。见[api参考/短信类型] | CommonNotice |
| signatureIdStr | String | 否 | 签名ID | sms-signQxkiwz88470 |
| startTime | String | 否 | 查询开始时间，时间格式为 yyyy-MM-dd | 2023-07-10 |
| endTime | String | 否 | 查询结束时间，时间格式为 yyyy-MM-dd | 2023-07-20 |
| pageNo | String | 否 | 页码，默认1 | 1 |
| pageSize | String | 否 | 页大小，默认50 | 50 |
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| totalCount | int | 总数 |
| pageNo | String | 当前页码 |
| pageNo | String | 分页大小 |
| blacklists | List |
结果列表，是个BlackItem 数组 |
BlackItem定义
| 参数名称 | 类型 | 描述 |
|---|---|---|
| phone | String | 手机号 |
| type | String | 黑名单类型 |
| smsType | String | 短信类型 |
| signatureIdStr | String | 签名ID |
| updateDate | String | 更新时间yyyy-MM-dd HH:mm:ss |
请求示例
GET /sms/v3/blacklist?phone=13800000000&smsType=CommonNotice HTTP/1.1
Host: 127.0.0.1:8420
Authorization: bce-auth-v1/203069ff6d1145548efbccc0aeaf8b5a/2023-07-14T03:37:35Z/1800/host;x-bce-date/864b39a36411f975c1a9781ee748f19c17cbba94fb050551a15f9f9971ea9bba
User-Agent: bce-sdk-java/0.10.108/Mac_OS_X/10.15.2/Java_HotSpot(TM)_64-Bit_Server_VM/25.192-b12/1.8.0_192/zh/
Date: Fri, 14 July 2023 03:37:35 GMT
Content-Type: application/json
x-bce-date: 2023-07-14T03:37:35Z
Content-Length: 129
Connection: Keep-Alive
Accept-Encoding: gzip,deflate响应示例
HTTP/1.1 200 OK
x-bce-request-id: 2513d3aa-294c-4860-971b-07e7a24b07d8
Cache-Control: no-cache
Content-Length: 0
Date: Fri, 14 July 2023 07:19:48 GMT
Server: BWS
{
"blacklists": [
{
"phone": "13800000000",
"type": "SignatureBlack",
"smsType": "CommonNotice",
"signatureIdStr": "sms-sign-hHYgtS57924",
"updateDate": "2023-07-18 10:59:17"
}
],
"totalCount": 1,
"pageNo": 1,
"pageSize": 100
}