系统开发文档 对外接口文档 车辆档案信息接口文档
{{item.name}}
{{itm.name}}
{{apiInfo.name}}
{{apiInfo.describe}}
本文档介绍单独访问地址:http://wx.xwykj.com/openapi/doc?docid={{apiInfo.id}}
开放平台接口 开发说明:
  • 开发步骤:1、提供白名单ip地址。 2、我们平台创建开放平台账号,由我方工作人员提供平台开发所需的appid、appsecret。 3、通过appid和appsecret获取接口访问token。 4、开发相关业务接口,根据不同的接口文档的要求提供所需的业务参数以外,还要携带 appid 、 token 、timeStamp 以及sign。
  • 请点击左侧接口分组列表获取你要对接开发的相关接口。如有相关疑问可以联系商务经理拉群,提供技术支持。
  • baseUrl 请求地址:http://wx.xwykj.com/openapi/
  • appid和appsecret由本平台提供。使用appid和appsecret获取访问的token。后面请求所有接口均要携带此访问token。其中token有效期为7200秒,有效期内重复获取返回相同结果。过期后可重新请求获取新的token。
  • 为了提高账户安全性,所有的接口访问均需要白名单控制,需要将你的请求服务器IP地址提供给我们销售经理,设置到白名单中才可正常访问接口。
  • 公共返回的参数有三项,status、info、data。 其中:status 【1】代表返回成功 【0】代表失败。 info :为返回的文字说明(正确、错误均有说明) data: 为返回的值。如果为错误则通常不返回data。
  • 获取token的接口只要appid和appsecret即可,其他的接口除了传递业务参数以外,还需要带上appid、token、sign、timeStamp 这四个公共的参数,一起post到接口上。
  • sign签名规则如下: 所有需要请求的值 转json字符串 再md5 然后和 appid 、 token 、timeStamp 一起拼接成字符串 最后再md5 组成签名。 举例说明:md5(md5(json_encode(param))+appid+token+timeStamp),其中param为需要请求的业务参数,将业务参数转成json字符串,进行md5,然后与appid、token、时间戳timeStamp拼接起来,组成新的字符串,最后再md5,生成签名。
  • 注意:appid 、 token 、timeStamp 以及sign 不需要参与转json运算。
  • 时间戳为秒数,请求的时间与北京时间相差不要超过5分钟。 时间戳为格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数。
  • 接口请求地址:
    POST
    baseUrl+ {{apiInfo.api_url}}
    请求参数:
    {{item.name}}
    {{item.field_name}} {{item.is_require == 1? '是':'否'}} {{item.field_describe}}
    page 分页参数,当前请求第几页的数据,默认显示第一页
    perpage 分页参数,每页显示多少条记录,默认显示10条
    接口及返回参数说明:
    返回数据样本: