简要描述:

  • 获取开关锁报表

接口版本:

版本号 制定人 制定日期 修订日期
2.0.0 lenny 2020-08-20 2020-08-20

请求URL:

请求头:

参数名 是否必须 类型 说明
Content-Type string 请求类型: application/json

请求参数:

参数名 是否必须 类型 说明
FTokenID string 令牌ID
FAction string 方法名 (QueryReportOpenLockList)
FGUIDs string 车辆/设备唯一标识(多个以英文逗号隔开)
FSelectType int 1:按车辆查;0:按终端查
FStartTime datetime 开始时间 (UTC时间)
FEndTime datetime 结束时间 (UTC时间)
FDateType int 1:按接收时间查;0:按GPS时间查
#### 返回示例:

正确时返回:

{
    "Result": 200,
    "Message": "check token success",
    "FObject": [
        {
            "FGUID": "be2a1e27-b36e-4301-b2c8-465a62ad2153",
            "FVehicleGUID": "be2a1e27-b36e-4301-b2c8-465a62ad215f",
            "FVehicleName": "粤BXX3453",
            "FAssetGUID": "9c1d9a6d-9daf-4e8c-b409-0127743325ce",
            "FAssetID": "7581213453",
            "FAssetTypeID": 701,
            "FDateTime": "2020-08-20T01:55:35",
            "FLongitude": 113.917915,
            "FLatitude": 22.580486,
            "FMileage": 1,
            "FType": 1,
            "FOpenType": 2"FUserName": ""
        },
        {
            "FGUID": "be2a1e27-b36e-4301-b2c8-465a62ad2252",
            "FVehicleGUID": "be2a1e27-b36e-4301-b2c8-465a62ad215f",
            "FVehicleName": "粤BXX3453",
            "FAssetGUID": "9c1d9a6d-9daf-4e8c-b409-0127743325ce",
            "FAssetID": "7581213453",
            "FAssetTypeID": 701,
            "FDateTime": "2020-08-20T02:38:03",
            "FLongitude": 113.917475,
            "FLatitude": 22.580903,
            "FMileage": 1,
            "FType": 1,
            "FOpenType": 2,
            "FUserName": ""
        } 
    ]
}

错误时返回:

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

返回参数说明:

参数名 类型 说明
FGUID String 开关锁唯一标识
FVehicleGUID String 车辆唯一标识
FVehicleName String 车牌号
FAssetGUID String 设备唯一标识
FAssetID String 设备ID
FAssetTypeID Int 设备类型
FDateTime DateTime 开关锁GPS时间
FLongitude Decimal 经度
FLatitude Decimal 纬度
FMileage Int 里程
FType Int 锁状态 (1:开;0:关)
FOpenType Int 开锁类型 (-3:应急仓关 -2拍照上锁 -1:关锁 1:刷卡;2:远程;3:蓝牙 4:剪绳开锁 5:短信开锁 6:按键开锁 7:NFC开锁 8:进区域触发开锁 9:应急仓开)
FCreateTime DateTime 创建时间
FUserName String 开锁人

备注:

  • 更多返回错误代码如下:
  • 104:token错误或过期
  • 105:异常错误
  • 102:请求参数错误

请求示例:

Java:

String result = "";
//请求路径
String url = "https://cloud.assetscontrols.com:3443/OpenApi/Report";  
//请求参数 ,json格式参数,建议用对象传入
String body = "{FAction:\"QueryReportOpenLockList\",FTokenID:\"3acef045-d302-4032-b40a-d9ee6c1519cd\",FGUIDs:\"BE2A1E27-B36E-4301-B2C8-465A62AD215F,FE0BDE75-4A30-4B9C-AD2E-66D8A4F44F5E\",FSelectType:\"1\",FStartTime:\"2020-08-18 16:00:00\",FEndTime:\"2020-08-25 15:59:59\",FDateType:\"0\"}";
URL realUrl = new URL(url);
// 设置通用请求的属性
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");
// 发送POST请求必须设置如下两行
conn.setDoOutput(true);
conn.setDoInput(true);
PrintWriter pw = new PrintWriter(conn.getOutputStream());
// 发送请求参数
pw.print(body);
// flush输出流的缓冲  
pw.flush();   
// 定义BufferedReader输入流来读取URL的响应
BufferedReader bufReader = new BufferedReader(new InputStreamReader(conn.getInputStream()));  
// 定义BufferedReader输入流来读取URL的响应
String line;
while ((line = bufReader.readLine()) != null) {
     result += line;        
 }
//返回的是json字符串
return result;

C#:

//请求路径
string url = "https://cloud.assetscontrols.com:3443/OpenApi/Report";  
//请求参数 ,json格式参数,建议用对象传入
string body = "{FAction:\"QueryReportOpenLockList\",FTokenID:\"3acef045-d302-4032-b40a-d9ee6c1519cd\",FGUIDs:\"BE2A1E27-B36E-4301-B2C8-465A62AD215F,FE0BDE75-4A30-4B9C-AD2E-66D8A4F44F5E\",FSelectType:\"1\",FStartTime:\"2020-08-18 16:00:00\",FEndTime:\"2020-08-25 15:59:59\",FDateType:\"0\"}"; 
Encoding encoding = Encoding.UTF8;
HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
 //请求方式 post / get
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字符串
    return reader.ReadToEnd();
}

Python:

 url = 'https://cloud.assetscontrols.com:3443/OpenApi/Report'
      data = {
      'FAction': 'QueryReportOpenLockList',
      'FTokenID': '3acef045-d302-4032-b40a-d9ee6c1519cd',
      'FGUIDs':'BE2A1E27-B36E-4301-B2C8-465A62AD215F,FE0BDE75-4A30-4B9C-AD2E-66D8A4F44F5E',
      'FSelectType':1,
      'FStartTime':'2020-08-05 16:00:00',
      'FEndTime':'2020-08-12 15:59:59',
      'FDateType':0
       }
      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;

Node.js:

文档更新时间: 2025-11-10 15:22   作者:刘家帅