简要描述:

  • 查询司机信息列表

接口版本:

版本号 制定人 制定日期 修订日期
2.0.0 lenny 2026-03-02

请求URL:

请求方式:

  • POST

请求头:

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

请求参数:

参数名 是否必须 类型 说明
FTokenID string 令牌ID
FAction string 方法名 (QueryAdminDriverList)
FPageIndex int 页数
FPageSize int 每页数量
FKey string 模糊搜索字段,按司机名或者司机手机号查
FAgentGUID string 公司唯一标识,该字段不传,默认查询该账户所在公司

返回示例:

正确时返回:

{
    "Result": 200,
    "Message": "check token success",
    "FObject": {
        "Table": [
            {
                "FTotalCount": 3   //分页总数量
            }
        ],
        "Table1": [
            {
                "FGUID": "e7eb61fb-3e54-4f65-9748-cd6fde97086a",
                "FDriverName": "suly",
                "FLicenseNumber": "粤8542111",
                "FDrivingType": "A1",
                "FDriverPhone": "15625215199",
                "FDescription": "20240228测试23",
                "FAgentGUID": "661e7209-c77e-4a54-afb8-6d956f962bdf",
                "FCreateTime": "2024-02-20T05:51:57.733",
                "FCountryResidenc": "深圳市",
                "FDistrictRegion": "宝安区",
                "FIDNumber": "415252632122232233",
                "FDrivingLicenseFrontUrl": "http://120.25.245.20:8081/Picture/Driver/2a325bf851584f7bb1365a86acc6a5fc.jpg",
                "FHeadPortraitUrl": "",
                "FDrivingLicenseBackUrl": "",
                "RowNo": 2,
                "FAgentName": "软件测试部"
            } 
        ]
    }
}

错误时返回:

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

返回参数说明:

参数名 类型 说明
FGUID string 司机信息唯一标识
FDriverName string 司机名称
FLicenseNumber string 司机电话
FDriverPhone string 路线名称
FIDNumber string 司机身份证号
FDescription string 描述
FCountryResidenc string 城市
FDistrictRegion string 城镇
FHeadPortraitUrl string 头像图片Url
FDrivingLicenseFrontUrl string 驾驶证正面照片Url
FDrivingLicenseBackUrl string 驾驶证反面照片Url
FAgentGUID string 公司唯一标识
FAgentName string 公司名称

备注:

  • 更多返回错误代码如下:
  • 104:token错误或过期
  • 105:系统异常
  • 102:请求参数错误
  • 106:有设备号为空
  • 107:有已存在的设备ID
  • 108:有车辆已绑定设备
  • 109:有错误的设备类型

请求示例:

Java:

String result = "";
//请求路径
String url = "https://cloud.assetscontrols.com:3443/OpenApi/Admin";  
//请求参数 ,json格式参数,建议用对象传入
String body = "{\"FAction\":\"QueryAdminDriverList\",\"FAgentGUID\":\"\",\"FKey\":\"su\",\"FPageIndex\":1,\"FPageSize\":50,\"FTokenID\":\"3acef045-d302-4032-b40a-d9ee6c1519cd\"}";  
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/Admin";  
//请求参数 ,json格式参数,建议用对象传入
string body = "{\"FAction\":\"QueryAdminDriverList\",\"FAgentGUID\":\"\",\"FKey\":\"su\",\"FPageIndex\":1,\"FPageSize\":50,\"FTokenID\":\"3acef045-d302-4032-b40a-d9ee6c1519cd\"}"; 
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/Admin'
      data = {
      'FAction': 'QueryAdminDriverList',
      'FTokenID': '3acef045-d302-4032-b40a-d9ee6c1519cd',
      'FKey': 'su',
       'FPageIndex': 1
        'FPageSize': 20
       }
      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;
文档更新时间: 2026-03-02 13:58   作者:刘家帅