接口文档（新）
更新时间：2026-07-31 20:00:29
羊毛党检测
协议说明
本接口用于检测手机号是否为羊毛党号码，识别恶意刷单、刷券等欺诈行为。
| 名称 | 说明 |
|---|---|
| 协议 | HTTPS POST |
| 编码格式 | UTF8 |
| Content-Type | application/json |
| URL | https://wsapi.253.com/api/v2/sdk/wool/wcheck |
请求头参数
请求头参数以及生成规则，可参考文档中的通用请求头：通用请求头
请求参数说明
请求参数 Body 以 application/json（JSON Body）方式提交
| 字段名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| mobile | String | 是 | 检测手机号，限单个，仅支持11位国内号码预验证11 位手机号码，和加密数据字段二选一 |
| ip | String | 否 | 手机IP地址：重要参数；不传或将对检测结果产生影响，不能传入10,192,172等开头的内网IP地址 |
| type | String | 否 | 查询类型 1：MD5(32位小写)，0：普通手机号；默认0 |
请求示例
{
"mobile": "13800138000",
"ip": "116.228.55.123",
"type": "0"
}请求结果说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | String | 返回状态码，仅使用 OM 标准 code 码，详细列表请参考：统一错误码 |
| msg | String | 响应 code 码解释 |
| requestId | String | 订单号 |
| chargeStatus | int | 是否收费，枚举值：1 ：收费 0：不收费 |
| chargeCount | int | 计费条数 |
| data | Object | |
| mobile | String | 手机号，仅支持国内号码，11 位 |
| tradeNo | String | 交易号，唯一。样例：18041109215057630 |
| status | String | 检测结果，枚举值：W1：白名单 B1 ：黑名单 B2 ：可信用度低 N：库无 |
| score | number | 检测分值，分值越高，风险越高。W1:[0-60); B2:[60-90); B1:[90-100] |
请求成功-结果示例
{
"msg": "success",
"chargeCount": 1,
"code": "000000",
"data": {
"score": 0,
"tradeNo": "aQWs1221096148769628160",
"mobile": "15727579729",
"status": "W1"
},
"requestId": "aQWs1221096148769628160",
"chargeStatus": 1
}请求失败-结果示例
{
"msg": "系统错误",
"chargeCount": 0,
"code": "301000",
"requestId": "PhcE1222590326496894976",
"chargeStatus": 0
}这篇文档对您有帮助吗？
