概要
本文详细介绍淘宝照妖镜查号API的功能、调用方式、参数说明及返回数据解析,帮助用户快速集成买家账号风险自动检测能力,适用于商家运营风控场景。
淘宝照妖镜接口介绍
照妖镜验号接口是一款通过淘宝开放平台(或第三方数据服务)提供的买家账号风险评估接口,可检测:
-
买家账号是否被淘宝风控(黑号/降权号)
-
历史违规记录(降权、打假、退款纠纷等)
-
账号活跃度及可信等级
典型应用场景:
1.单前筛查高危买家号
2.商家风控系统集成
3.反作弊数据分析
照妖镜API接口基础信息
项目说明
接口地址:https://tool.sd1118.com/api/tool/checkAccount
请求方式:POST(推荐HTTPS加密)
数据格式:JSON
权限认证:API Key + 签名验证
请求参数
1. 必填参数
{
"app_key": "您的API密钥",
"taobao_id": "买家淘宝ID或昵称",
"timestamp": "当前时间戳(秒级)",
"sign": "请求签名(见下方签名算法)"
}
2. 可选参数
参数名 | 类型 | 说明 |
---|---|---|
check_detail | int | 是否返回详细记录(0/1) |
risk_level | string | 指定风险等级过滤 |
调用示例
import requests
import time
api_url = "https://tool.sd1118.com/api/tool/checkAccount"
params = {
"app_key": "YOUR_API_KEY",
"taobao_id": "xiaofulu222",
"timestamp": int(time.time()),
"check_detail": 1
}
params["sign"] = generate_sign(params, "YOUR_API_SECRET") # 使用前文签名函数
response = requests.post(api_url, json=params)
print(response.json())
返回示例
成功响应(200)
{
"code": 200,
"data": {
"taobao_id": "xiaofulu222",
"risk_score": 85,
"risk_tags": ["高频退款", "疑似S单"],
"detail": [
{
"date": "2023-05-21",
"behavior": "异常批量下单",
"platform_action": "订单降权"
}
]
}
}
错误码对照表
错误码 | 说明 | 解决方案 |
---|---|---|
400 | 参数缺失/格式错误 | 检查必填字段 |
403 | API密钥无效 | 联系服务商更新密钥 |
500 | 服务器内部错误 | 重试或提交工单 |
注意事项
-
频率限制:单IP限制100次/分钟,超频将临时封禁
-
数据缓存:查询结果默认缓存24小时(重复查询返回缓存数据)
-
合规使用:禁止用于非法爬取或侵犯隐私行为
-
淘宝风控:频繁调用可能触发淘宝安全机制,建议模拟自然人行为