# shangqi **Repository Path**: sunyiming0328/shangqi ## Basic Information - **Project Name**: shangqi - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2024-08-06 - **Last Updated**: 2024-08-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 上汽平台 接口说明文档 ### 获取车辆数据明细流程： ①接口1：登录接口获取token，获取访问数据的权限； ②接口2：根据车辆vin查询车辆信息接口，获取车辆unid和车辆对应的数据字典fiber_unid等信息； ③接口3：根据车辆unid查询code和code对应的数据（即此车辆数据明细）； ④接口4：根据fiber_unid查询code和对应的code别名。 ### 1、登录 ### 1.1请求格式 URL https://shangqi.wlwltech.com/oauth/token 支持格式 http请求格式 POST 是否登录验证 False 请求数限制 No 是否完成 Yes ### 1.2参数说明 参数名称 必选 类型及范围 默认值 说明 grant_type true param password client_id true param 597494481295-dd79sund7ef8kr338t87eqajl27spg7a.apps.cube.com client_secret true param daf2333dd314xfd scope true param 功能路径地址，非固定 username true param 登录用户名 password true param 密码 其中scope： /bigger/vehicle /bigger/fiber /sensor/vehicle /bigger/enum ### 1.3正常返回结果 返回键 类型 返回值 说明 text access_token={}&id={}&expires_in={} ### 1.4错误返回列表 见附件1 测试示例： 测试接口为：https://shangqi.wlwltech.com/oauth/token ### 2、根据vin查询车辆unid和fiber_unid等信息 ### 2.1请求格式 URL https://shangqi.wlwltech.com/bigger/vehicle/info?q={vin} 支持格式 JSON http请求格式 get 是否登录验证 yes 请求数限制 no 是否完成 No ### 2.2参数说明 参数名称 必选 类型及范围 说明 Authorization header 有效的token Accept header application/json ### 2.3正常返回结果 [ { "type": "vehicle", "domain_unid": "0034DDC8734C4EBFAD56BAF9DD1B64E9", "flag_del": false, "unid": "276D8F32B73946BFA2D3CBEAC0C65EC0", "fiber_unid": "6CAAFB8B6F334BA0865197DD7C539A63", "fiber": "申沃EN11", "LAT_D": 0, "licence": "沪A06782D", "LON_D": 0, "model_unid": "67B9307E72344E55AA19975F9F7790E9", "model": "SWB6128EV56", "name": "S2V-0248", "type_unid": "2C3A62167F0941AF82532629C16BBA06", "vin": "LSFD13205GC001837", "platform": "276D8F32B73946BFA2D3CBEAC0C65EC0", "iccid": "1064620787220", "device_model": "3508562EE8514B7D9A008C5061E8458D", "device_id": "B30505", "domain": "157路", "snapshot": { "entry": [ { "key": "alter_count", "value": "0" }, { "key": "remotelockset", "value": "-" }, { "key": "LON_D", "value": "121.42921443279835" }, { "key": "devi …… ### 2.4错误返回列表 见附件1 测试示例： 例如：一辆上汽车辆vin为LSFD13205GC001837： 获取接口1中的token为8e6c0a6d604d4a9d1224677b1754bbe3 测试接口为：https://shangqi.wlwltech.com/bigger/vehicle/info?q=LSFD13205GC001837 查询到"unid": "276D8F32B73946BFA2D3CBEAC0C65EC0", "fiber_unid": "6CAAFB8B6F334BA0865197DD7C539A63", ### 3、根据车辆unid查询数据明细 ### 3.1请求格式 URL https://shangqi.wlwltech.com/sensor/vehicle/{unid}?field={field} 支持格式 JSON http请求格式 get 是否登录验证 yes 请求数限制 no 是否完成 No ### 3.2参数说明 参数名称 必选 类型及范围 说明 Authorization header 有效的token如： Bearer 812cfd3ee510c738a5ce22041c565f4b Accept header application/json field param RPM%2CMILEAGE_GPS%2CVERSION_FW%2CVERSION_HW%2CDATIME_CAN%2Cnlr60ou%2Cfljbfxt%等 说明：unid为车辆unid，field数据是由所有的code拼装而成，code来自接口4 ### 3.3正常返回结果 返回键 类型 返回值 说明 [ { "column": [ "TIMESTAMP", "RPM", "MILEAGE_GPS", "VERSION_FW", "VERSION_HW", "DATIME_CAN", …… ] }, { "column": [ "2017-08-08 16:08:08", "888", "8000.800", "1.1.22.3", "61234", "2017-12-05 16:52:47", "0", "0", "0", "0", "0", "0", "0", "1", "0", "0", "0", "0", "0", "0", "0", "0", "1", "0", "0", …… ] } ] 测试示例： 获取接口1中的token为8e6c0a6d604d4a9d1224677b1754bbe3 在接口2中获取车辆unid为：276D8F32B73946BFA2D3CBEAC0C65EC0 测试接口为： https://shangqi.wlwltech.com/sensor/vehicle/276D8F32B73946BFA2D3CBEAC0C65EC0?field=RPM%2CMILEAGE_GPS%2CVERSION_FW%2CVERSION_HW%2CDATIME_CAN%2Cpz80nn1%2Ccu93mto%2Cvfz4b4f%2Cyfjs9wy%2Cto63b2m%2Chmk24na%2Cyha3agh%2Cwbsbo0n%2Cjp00hy0%2Cves84ru%2Cmediryk%2Cdct6ft1%2Cmo7y8b5%2Cvpr8vwq%2Ctagywx4%2Cto24p0l%2Ccvl7sj7%2Cdv46liy%2Cblhn7gn%2Cpv3hafl%2Czlblpz1%2Cyrsp480%2Cikwd4zz%2Cikq2u86%2Cjez25m4%2Cte4ta5i%2Cfhhjgno%2Cgqwpl0q%2Cynmw135%2Cpdhz45x%2Cfkj0rfg%2Cthzd5ar%2Cdmjumh3%2Cjk1wok3%2Ciop878n%2Cnxgky7b%2Cuwb9qb7%2Cxkm8vsb%2Cttdxamq%2Cwrz9zzd%2Ceqif050%2Cspl9idh%2Cuoi37lo%2Cjx37uuj%2Cmb6k4ai%2Clc620nr%2Czlp8mj9%2Cwj8xb1y%2Cfxzf4s2%2Cnv0zlgg%2Cne6klzo%2Cpynnr5u%2Cgtvp04k%2Cfs4xdnw%2Cpixek17%2Cathld27%2Ckfqtbzb%2Cyr1vgyh%2Cmsq4j5x%2Clktgmq6%2Cqjxlqir%2Cagqmapz%2Cynph080%2Cztdyeuu%2Chtrhhwc%2Cwj2bzbi%2Cogjbi0z%2Cfzoxej6%2Cyytdz8b%2Cbhtdi92%2Cdnapinv%2Cfaq9bqs%2Cojvrrbd%2Cyxk3cgc%2Caaqlkbn%2Cdemlz4t%2Cta7zhz3%2Cogtm58v%2Cpc7isr8%2Ciexs3ic%2Cdd5wz08%2Clx2enoo%2Chw7ikqb ### 4数据字典查询 ### 4.1请求格式 URL 根据fiber_unid查询code和code对应的别名、名称：https://shangqi.wlwltech.com/bigger/fiber/{fiber_unid} 支持格式 JSON http请求格式 get 是否登录验证 yes 请求数限制 no 是否完成 No ### 4.2参数说明 参数名称 必选 类型及范围 说明 Authorization header 有效的token Accept header application/json ### 4.3正常返回结果 { "type": "fiber", "domain_unid": "CA1D9CEA351E4DE8817135BF31936C66", "flag_del": false, "unid": "6CAAFB8B6F334BA0865197DD7C539A63", "name": "申沃EN11", "root_proto_unid": "CD039E17A8E84137AF6DE1CDC172C274", "column_group": { "columns": [ { "alias": "", "code": "guqi2ed", "title": "包头", "length": 0 }, { "alias": "", "code": "gta82ei", "title": "终端消息命令号", "length": 0 }, { "alias": "", "code": "wxqh8dh", "title": "终端消息长度", "length": 0 }, { "alias": "", "code": "wk41xde", "title": "CAN网络消息命令号", "length": 0 }, { "alias": "", "code": "yb0baj0", "title": "CAN网络消息长度", "length": 0 …… ### 4.4错误返回列表 见附件1 ### 测试示例： 获取接口1中的token为8e6c0a6d604d4a9d1224677b1754bbe3 在接口2中获取fiber_unid为6CAAFB8B6F334BA0865197DD7C539A63 测试接口为：https://shangqi.wlwltech.com/bigger/fiber/6CAAFB8B6F334BA0865197DD7C539A63 ### 附件1 https返回结果 错误码 说明 404 没有数据返回 401 没有权限 500 服务端错误 201 新增成功 200 访问成功