生成浏览器指纹
最近更新:2024-09-29 20:05:49
生成浏览器指纹
POST /api/v1/env/create
接口说明
· 功能:生成指纹信息,用于后续的指纹查询。
· 协议: http
· method: post
· uri: /api/v1/env/create
请求参数
名称 | 类型 | 是否必须 | 字段含义 | 备注 |
envName | string | 否 | 名称 | |
system | string | 是 | 操作系统 | 目前支持: Windows 7,Windows 8,Windows 8.1,Windows 10,Windows 11 |
uaVersion | string | 否 | ua大版本号 | 范围 100-124 |
publicIp | string | 是 | 公网ip | |
ipChannel | string | 否 | ip检测渠道 | 可为空,枚举 ip2location(国外),ipdata(国内) |
kernel | string | 否 | 内核类型 | 枚举 chrome |
kernelVersion | string | 是 | 内核版本 | 119 |
serial | string | 否 | 环境编号 | 最大长度64位字符 |
customerId | string | 否 | 客户自定义的id | 最大32位字符 |
请求示例
http://localhost:50213/api/v1/env/create
请求体
{
"system": "Windows 7",
"uAversion": "119",
"publicIp": "27.126.205.230",
"ipChannel": "ipdata",
"kernelVersion": "119",
"kernel": "chrome"
}
返回数据
名称 | 类型 | 是否必须 | 字段含义 | 备注 |
reqId | string | 是 | 请求唯一id | |
code | int | 是 | 响应码 | |
msg | string | 是 | 响应提示 | |
data | string | 否 |
data 节点
名称 | 类型 | 是否必须 | 字段含义 | 备注 |
envId | string | 是 | 指纹id | |
customerId | string | 是 | 客户自定义的id |
示例
成功示例
{
"reqId": "c40199ddb5e2407cba47495ed1bb3cae",
"code": 200,
"msg": "OK",
"data": {
"envId": "619a15aee2f64a9bbb9993dd006ecc46",
"customerId": "xxxxxxxx"
}
}
code状态码
code | 备注 |
-1 | 失败 |
200 | 成功 |
500 | 服务器错误 |
1060 | appid缺失 |
1061 | timestamp缺失 |
1062 | 签名缺失 |
1063 | envelop缺失 |
1064 | timestamp误差过大 |
1065 | appId非法 |
1066 | envelop非法 |
1067 | signature非法 |
1068 | appSecret非法 |
1069 | appId非法 |
1070 | 调用次数超限 |
1071 | 余额不足 |
1072 | 钱包不存在 |
10057 | envId不能为空 |
10058 | 指纹信息不存在 |