Create Browser Fingerprint
API Description#
Function: Generate fingerprint information for subsequent queries
Request Parameters#
| Name | Type | Required | Description | Remarks |
|---|
| envName | string | No | Name | |
| system | string | Yes | Operating system | Supported: Windows 7, Windows 8, Windows 8.1, Windows 10, Windows 11 |
| uaVersion | string | No | UA major version | Range 100-124 |
| publicIp | string | Yes | Public IP | |
| ipChannel | string | No | IP detection channel | Enum: ip2location(overseas), ipdata(domestic) |
| kernel | string | No | Kernel type | Enum: chrome |
| kernelVersion | string | Yes | Kernel version | e.g. 119 |
| serial | string | No | Environment serial number | Max length 64 characters |
| customerId | string | No | Custom client ID | Max length 32 characters |
Request Example#
POST http://localhost:50213/api/v1/env/create
{
"system": "Windows 7",
"uAversion": "119",
"publicIp": "27.126.205.230",
"ipChannel": "ipdata",
"kernelVersion": "119",
"kernel": "chrome"
}
Response Data#
| Name | Type | Required | Description | Remarks |
|---|
| reqId | string | Yes | Request unique ID | |
| code | int | Yes | Response code | |
| msg | string | Yes | Response message | |
| data | string | No | Fingerprint ID | |
Data Fields#
| Name | Type | Required | Description | Remarks |
|---|
| envId | string | Yes | Fingerprint ID | |
| customerId | string | Yes | Custom client ID | |
Example Response#
{
"reqId": "c40199ddb5e2407cba47495ed1bb3cae",
"code": 200,
"msg": "OK",
"data": {
"envId": "619a15aee2f64a9bbb9993dd006ecc46",
"customerId": "xxxxxxxx"
}
}
Status Codes#
| Code | Description |
|---|
| -1 | Failure |
| 200 | Success |
| 500 | Server error |
| 1060 | Missing appid |
| 1061 | Missing timestamp |
| 1062 | Missing signature |
| 1063 | Missing envelope |
| 1064 | Timestamp deviation too large |
| 1065 | Invalid appId |
| 1066 | Invalid envelope |
| 1067 | Invalid signature |
| 1068 | Invalid appSecret |
| 1069 | Invalid appId |
| 1070 | Call limit exceeded |
| 1071 | Insufficient balance |
| 1072 | Wallet not found |
| 10057 | envId cannot be empty |
| 10058 | Fingerprint information does not exist |
Modified at 2025-06-21 02:15:40
