This API is provided by a third-party system to query the current real-time status data of devices, and it is offered by either the third-party system or JointCloud. You can refer to the examples below to provide API documentation.
Interface Address
https://api.example.com/QueryAdminAssetListByFAssetIDs
A fixed URL for this interface can be negotiated between both parties.
Request Method
- Post
Request Headers
- Content-Type: application/json
- token: A334853698EF49DC98A1C8BA65149351 (A fixed token value can be negotiated between both parties)
Request Parameters
Parameter Example
{
"assetIds":"709221546546,791659866125"
}
Parameter Description
Field | Type | Description | Required |
---|---|---|---|
assetIds | string | Device numbers, with multiple ones separated by English commas | Y |
Return Result
Result Example
{
"code": 200,
"message": "Operation succeeded",
"data": [
{
"deviceId": "709221546546",
"deviceType": 709,
"battery": 60,
"onlineStatus": 1,
"gpsSignal": 24,
"gsmSignal": 20,
"lat": 22.126542,
"lon": 113.254632,
"gpsTime":"2025-04-25 06:20:59",
"networkType": 1
},
{
"deviceId": "791659866125",
"deviceType": 701,
"battery": 90,
"onlineStatus": 1,
"gpsSignal": 24,
"gsmSignal": 20,
"lat": 22.126542,
"lon": 113.254632,
"gpsTime":"2025-04-25 06:20:59",
"networkType": 1
}
]
}
Result Description
Field | Type | Description |
---|---|---|
code | int | Status code; see “Status Code Description” for details |
message | String | Request status description |
data | object | Return result content |
Data Description
Field | Type | Description |
---|---|---|
deviceId | String | Device number |
deviceType | Int | Device type (701: JT701, 709: JT709, 705: JT705C) |
battery | Int | Battery level |
onlineStatus | Int | Network status (0: Not connected; 1: Connected; -1: Unknown) |
gpsSignal | Int | Satellite signal value |
gsmSignal | Int | GSM signal value |
lat | double | Latitude |
lon | double | Longitude |
gpsTime | String | Positioning time |
networkType | String | Network type (2: 2G, 3: 3G, 4: 4G, 5: 5G; others are invalid) |
文档更新时间: 2025-07-23 11:49 作者:admin