如何接入

接入步骤

第三方合作企业, 通过如下步骤即可接入车智汇开放平台:

一. 申请接入账号

合作方企业与车智汇达成合作条件后, 车智汇会为合作方企业创建车智汇开放平台的账号, 账号包括如下两个部分:

二. 申请服务接口权限

1.合作方企业与车智汇达成合作条件后, 车智汇会为合作方企业开通相应的服务接口权限

2.未开通权限的服务接口是不允许调用的, 如果合作方企业想开通其他服务接口权限需要线下向车智汇申请

三. 调用服务接口, 完成接入

合作方企业参照服务接口文档的URL和参数传递方式，即可接入车智汇开放平台

公共参数

如何生成请求参数中的签名(sign)

在接口请求中有一个公共的签名(sign)参数需要计算生成, 生成步骤如下:

1. 拼接 appId、请求参数、secretKey、请求时间
2. 采用md5散列算法散列刚才拼接出来的字符串
3. 将结果转为全小写

伪代码如下:

String appId = "your appId";
String secretKey = "your secretKey";
Long time = now(); // 时间戳, 精确到秒(s)
String param = JSON({"time":1477484314,......}); // 请求体中的JSON字符串
String signStr = md5(appId + param + secretKey + time);

注意: param中的time和md5时使用的time必须一致

接入示例

以下以"获取终端状态"接口为例，演示如何接入:

1.首先申请账号与密钥

假设申请到资源如下:

appId=abcdefg

secretKey=zxc

2.按照接口说明获取终端状态得到接口地址和参数

POST https://open.iauto360.cn/srv/1001/{appId}/{sign}

appId即为第1步中申请到的appId

sign为按照上述所说的方式生成的签名

3.按照接口说明获取终端状态组装请求体

请求体方式为: application/json

具体参数如下：

{
    "time":1468024618564,
    "data":{
        "esn":"86127667888972656"
    },
    "plan":1001
}

4.以POST方式请求, 如果得到如下类似格式结果，则调用成功

{
    "flag":1,
    "data":{
        "bindStatus":1,
        "mobile":13820001828,
        "plateNo":"粤AD12345",
        "inserted":1,
        "activeTime":1468028564
    }
}