号码检测

2023/7/11大约 6 分钟

号码检测

WS 筛号

通过 Excel 导入号码批量筛号，支持多种第三方筛号产品（由参数 operator 指定，如 WS 有效、WS 活跃、Flipkart 等）。

具体流程
导入 Excel 提交订单 → 轮询订单状态 → 下载结果 Excel。
收费方式
按 每条号码 计费，提交时按去重后的号码数量扣费，具体计费规则请联系客服。

operator 码表

提交接口参数 operator 取值如下。仅 已启用 的产品可提交。

operator	产品名称	备注
`filter`	WS有效筛选
`wsBanned`	WS封号筛选
`live`	WS活跃筛选	支持 `activeType`
`generalLive`	WS活跃区间筛选	支持 `activeType`
`gender`	WS性别年龄
`liveSystem`	WS活跃+系统筛选
`wsFullFormat`	WS全格式筛选
`line`	line有效筛选
`lineGender`	Line性别年龄筛选
`zalo`	zalo筛选
`zaloGender`	Zalo性别年龄筛选
`fb`	FaceBook筛选
`fbMessager`	FbMessager筛选
`twitter`	Twitter筛选
`microsoft`	微软账户筛选
`amazon`	亚马逊筛选
`ins`	Ins筛选
`tg`	TG筛选
`tgActive`	TG活跃筛选
`tgGender`	TG性别年龄筛选
`viber`	viber筛料
`viberActive`	viber活跃筛选
`rcs`	Rcs筛选
`rcsAndroid`	RCS-Android筛选
`rcsIos`	RCS-IOS筛选
`rcsSystem`	RCS系统筛选
`iosAndorid`	IOS筛选
`imessage`	Imessage筛选
`phoneCheck`	空号检测筛选	最少 2000 条
`operatorStandard`	海外运营商格式筛选
`operatorPremium`	海外运营商+1格式筛选
`operatorStandardUS`	海外运营商US高级筛选
`operatorStandardUSLive`	海外运营商US活跃筛选
`operatorStandardDnc`	US-DNC+活跃筛选
`operatorStandardLiveUS`	US-活跃筛选
`operatorStandardLive`	海外运营商活跃筛选
`vantageMarkets`	Vantage筛选
`kucoin`	Kucoin筛选
`snap`	Snap筛选
`sideline`	Sideline筛选
`dhl`	DHL筛选
`botim`	BOTIM筛选
`botimGender`	Botim性别筛选
`noon`	Noon筛选
`cian`	Cian筛选
`hh`	Hh筛选
`bukalapak`	Bukalapak筛选
`moniePoint`	MoniePoint筛选
`band`	Band有效筛选
`coupang`	Coupang筛选
`paytm`	Paytm筛选
`economictimes`	Economictimes筛选
`magicbricks`	Magicbricks筛选
`rummycircle`	Rummycircle筛选
`flipkart`	Flipkart筛选
`makemytrip`	Makemytrip筛选
`moj`	Moj筛选
`swiggy`	Swiggy筛选
`microsoftTeams`	MicrosoftTeams筛选
`foundit`	Foundit筛选
`mint`	Mint筛选
`linkedinSenior`	领英高级筛选
`linkedinSeniorGender`	领英性别年龄筛选
`ICIClBank`	ICIClBank筛选
`signal`	Signal筛选

产品启用状态可能随运营调整，以提交时校验结果为准。

导入 Excel 提交订单

描述
上传 Excel 文件提交筛号任务。系统读取 Excel 第一列（A 列） 作为号码列表（需含国家区号，如 919876543210）。

Excel 模板说明

项	说明
文件格式	`.xlsx` 或 `.xls`
数据列	仅第一列（A 列）
表头	可有可无；若有表头（如 `mobile`），非号码行会自动过滤
字段名	无固定要求，解析按列位置而非表头名称
号码格式	去掉非数字后至少 8 位；可含 `+`、空格、`-`
去重	提交时自动去重

推荐模板示例（带表头）：

mobile
919876543210
919876543211
918765432109

提交限制

限制项	说明
号码数量	去重后不少于 500 个、不超过 100 万个（`phoneCheck` 空号检测最少 2000 个）
国家	一个订单只能提交一个国家/地区的号码，由参数 `country` 指定；Excel 内号码需与该国家区号一致
产品	`operator` 须为已启用的筛号产品；无效或未启用将提交失败

号码会先自动去重再校验数量；不足最小条数或超过上限将提交失败。

URI
/group-dispatch-api/ws-scan/submit-excel
请求方式
POST、Content-Type: multipart/form-data

请求参数说明

参数名	类型	是否必填	备注
file	file	是	Excel 文件，第一列为号码
operator	string	是	筛号产品标识，对应数据吧 operator，如 `filter`、`live`、`flipkart`
country	string	是	国家/地区编码，如 `IN`、`MX`；单订单仅支持一个国家
activeType	int	否	活跃类型；`operator` 为 `live` 或 `generalLive` 时可选，默认 `2`

operator 取值
见上文 operator 码表；仅已启用的产品可提交。
activeType 说明（live / generalLive 时有效）
值说明
0 频繁上线
1 最近上线
2 近期上线（默认）
响应参数说明
参数名类型是否必填备注
code int 是状态码，200 为成功
message string 否描述
data object 否数据
data 参数说明
参数名类型是否必填备注
orderId string 是订单号，后续查询/下载时使用
响应示例

值	说明
`0`	频繁上线
`1`	最近上线
`2`	近期上线（默认）

参数名	类型	是否必填	备注
code	int	是	状态码，200 为成功
message	string	否	描述
data	object	否	数据

参数名	类型	是否必填	备注
orderId	string	是	订单号，后续查询/下载时使用

{
  "code": 200,
  "message": "success",
  "data": {
    "orderId": "20260616115517972861"
  }
}

请求示例

curl -X POST "https://{host}/group-dispatch-api/ws-scan/submit-excel" \
  -H "tenantId: {租户ID}" \
  -H "timestamp: {13位毫秒时间戳}" \
  -H "token: {签名token}" \
  -F "file=@phones.xlsx" \
  -F "operator=flipkart" \
  -F "country=IN"

活跃筛号示例：

curl -X POST "https://{host}/group-dispatch-api/ws-scan/submit-excel" \
  -H "tenantId: {租户ID}" \
  -H "timestamp: {13位毫秒时间戳}" \
  -H "token: {签名token}" \
  -F "file=@phones.xlsx" \
  -F "operator=live" \
  -F "country=IN" \
  -F "activeType=2"

查询订单状态

描述
根据提交接口返回的 orderId 查询筛号进度；建议轮询直至 orderStatus 为 1（已完成）或 2（失败）。
URI
/group-dispatch-api/ws-scan/status
请求方式
GET
请求参数说明
参数名类型是否必填备注
orderId string 是提交接口返回的订单号

参数名	类型	是否必填	备注
orderId	string	是	提交接口返回的订单号

响应参数说明

参数名	类型	是否必填	备注
code	int	是	状态码
message	string	否	描述
data	object	否	数据

data 参数说明

参数名	类型	是否必填	备注
orderId	string	是	订单号
orderStatus	int	是	订单状态，0 处理中 1 已完成 2 失败
orderStatusDesc	string	否	状态描述
productName	string	否	产品名称
operator	string	是	筛号产品标识
country	string	是	国家编码
totalNum	int	是	提交号码总数（去重后）

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "orderId": "20260616115517972861",
    "orderStatus": 1,
    "orderStatusDesc": "已完成",
    "productName": "Flipkart筛选",
    "operator": "flipkart",
    "country": "IN",
    "totalNum": 500
  }
}

获取结果 Excel 临时下载地址

描述
订单 已完成（orderStatus = 1）后，获取 OSS 临时签名下载链接。每次请求会重新生成，请勿长期缓存。
URI
/group-dispatch-api/ws-scan/export
请求方式
GET
请求参数说明
参数名类型是否必填备注
orderId string 是提交接口返回的订单号
响应示例

参数名	类型	是否必填	备注
orderId	string	是	提交接口返回的订单号

{
  "code": 200,
  "message": "success",
  "data": {
    "orderId": "20260616115517972861",
    "ossUrl": "https://...?Expires=...&Signature=..."
  }
}

下载结果 Excel

描述
订单 已完成（orderStatus = 1）后，直接下载筛号结果 Excel 文件流。文件内容为 第三方原始结果，列结构因 operator 不同而异。
URI
/group-dispatch-api/ws-scan/download
请求方式
GET
请求参数说明
参数名类型是否必填备注
orderId string 是提交接口返回的订单号

参数名	类型	是否必填	备注
orderId	string	是	提交接口返回的订单号

响应说明

场景	Content-Type	说明
成功	application/vnd.openxmlformats-officedocument.spreadsheetml.sheet	Excel 文件流，文件名 `{orderId}.xlsx`
失败	application/json	JSON 错误体，结构与常规接口一致

失败响应示例

{
  "code": 820,
  "message": "筛号错误"
}

结果文件说明
下载结果为数据吧返回的 原始 Excel，不同 operator 表头与列数不同。以下为常见产品参考（实际以第三方返回为准）：
WS 有效（operator=filter）
列表头说明
A mobile 提交的原始号码
B whats_mobile WhatsApp 注册号码；有值表示有效
C 是否商业号 0=非商业号，1=商业号
WS 活跃（operator=live）
列表头说明
A mobile 提交的原始号码
B whats_mobile WhatsApp 注册号码
C 最后活跃时间最后上线时间
D 活跃活跃天数或活跃小时数
E 是否商业号 0 否 1 是
F 状态 WhatsApp 状态
Flipkart（operator=flipkart）
列表头说明
A mobile 提交的原始号码
其他 operator 的列结构请参考对应产品说明或实际下载文件。

列	表头	说明
A	mobile	提交的原始号码
B	whats_mobile	WhatsApp 注册号码；有值表示有效
C	是否商业号	`0`=非商业号，`1`=商业号

列	表头	说明
A	mobile	提交的原始号码
B	whats_mobile	WhatsApp 注册号码
C	最后活跃时间	最后上线时间
D	活跃	活跃天数或活跃小时数
E	是否商业号	`0` 否 `1` 是
F	状态	WhatsApp 状态

列	表头	说明
A	mobile	提交的原始号码

常见错误

code	说明
`820`	筛号通用错误（订单不存在、Excel 解析失败等）
`823`	号码数量低于最小限制（普通产品 500，`phoneCheck` 2000）
`824`	号码数量超过最大限制（100 万）
`825`	`operator` 无效或未启用