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