Summary:

  • Getting single information of Device

Version:

No. Editor Edit date Revision date
2.0.0 admin 2022-06-06

Request URL:

Request mode:

  • POST

Request header:

Parameter Required field Data type Explanation
Content-Type Yes string application/json

Request parameter:

Parameter Required field Data type Explanation
FTokenID Yes string token
FAction Yes string QueryAdminAssetByAssetId
FAssetID Yes string Device Id

Response example:

Correct response:

{
    "Result": 200,
    "Message": "check token success",
    "FObject": [
        {
            "FGUID": "b8ac068d-b9c2-428f-ac52-5df88d069e5e",
            "FAssetID": "2690929719",
            "FAssetTypeID": 200,
            "FDescription": "",
            "FSIMNumber": "89860410102170005799",
            "FAgentGUID": "042032ac-6382-43b6-974f-7ec7f2c0fdfb",
            "FAgentName": "kelierbu",
            "FCreateTime": "2022-05-31T02:08:11.873",
            "FExpireTime": null,
            "FVehicleGUID": "d30bd042-f69a-4f81-ad64-bac303c70980",
            "FVehicleName": "2690929719"
        }
    ]
}

Error response:

{
    "Result": 102,
    "Message": "Action is error",
    "FObject": []
}

Return parameter description:

Parameter Data type Explanation
FGUID String Unique identification of device
FAssetID String Device Id
FAssetTypeID Int Device type
FDescription String Description
FSIMNumber String Sim No.
FAgentGUID String Unique identification of the company to which the device belongs
FAgentName String Company name
FCreateTime DateTime Registration time(UTC)
FExpireTime DateTime Expiration time(UTC)
FVehicleGUID String Unique identification of asset
FVehicleName String Assets name

Other result status description:

  • 104:Token error or expiration
  • 102:Request parameter error

Examples:

Java:

String result = "";
//Request url
String url = "http://cloud.assetscontrols.com:8092/OpenApi/Admin";
//Request parameters, JSON format parameters, it is recommended to pass in objects
String body = "{FAction:\"QueryAdminAssetByAssetId\",FTokenID:\"3acef045-d302-4032-b40a-d9ee6c1519cd\",FAssetID:\"2690929760\"}"; 
URL realUrl = new URL(url);
// Set properties of general request
URLConnection conn = realUrl.openConnection();
conn.setRequestProperty("accept", "*/*");
conn.setRequestProperty("connection", "keep-Alive");
conn.setRequestProperty("Content-Type", "application/json");
conn.setRequestProperty("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");
conn.setRequestProperty("method", "post");
conn.setDoOutput(true);
conn.setDoInput(true);
PrintWriter pw = new PrintWriter(conn.getOutputStream());
// Send request parameters
pw.print(body);
pw.flush();
BufferedReader bufReader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
String line;
while ((line = bufReader.readLine()) != null) {
     result += line;
 }
//JSON string is returned
return result;

C#(.NET):

//Request url
string url = "http://cloud.assetscontrols.com:8092/OpenApi/Admin";
//Request parameters, JSON format parameters, it is recommended to pass in objects
String body = "{FAction:\"QueryAdminAssetByAssetId\",FTokenID:\"3acef045-d302-4032-b40a-d9ee6c1519cd\",FAssetID:\"2690929760\"}"; 
Encoding encoding = Encoding.UTF8;
HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
request.Method = "post";
request.Accept = "*/*";
request.ContentType = "application/json";
request.UserAgent = "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)";
byte[] buffer = encoding.GetBytes(body);
request.ContentLength = buffer.Length;
request.GetRequestStream().Write(buffer, 0, buffer.Length);
HttpWebResponse response = (HttpWebResponse)request.GetResponse();
using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8))
{
    //JSON string is returned
    return reader.ReadToEnd();
}

Python:

url = 'http://cloud.assetscontrols.com:8092/OpenApi/Admin'
      data = {
      'FAction': 'QueryAdminAssetList',
      'FTokenID': '3acef045-d302-4032-b40a-d9ee6c1519cd',
      'FAssetID': '2690929719'
       }
      data = parse.urlencode(data).encode('utf-8')
      headers = {
       'User-Agent': r'Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) '
                     r'Chrome/45.0.2454.85 Safari/537.36 115Browser/6.0.3',
       'Connection': 'keep-alive'
       }
      req = request.Request(url, headers=headers, data=data)
      page = request.urlopen(req).read()
      page = page.decode('utf-8')
      # json_array = json.loads(page)
      return page;
文档更新时间: 2024-12-19 16:52   作者:刘家帅