开发说明 · CMSV6 车载平台帮助文档

Hi，以下是HTTP API接口的使用介绍，方便您快速轻松调用API进行系统集成，感谢您的使用！

1.调试流程

步骤一：找到用户登录接口，点击调试
步骤二：填入web服务host，请求参数栏填入账号密码信息后，点击执行，此时则拿到登录用户会话号
步骤三：调试接口【获取设备在线状态】，此时不用再填host，填入接口需要的参数后，点击执行

注意：

接口调用流程：1.登录（获取会话号） → 2.调用其他接口 → 3.注销
所有的接口均需要在登录的条件下，方可正常调用

2.参数编码

所有的请求和响应数据编码皆为utf-8格式，url里的所有参数值请做URIEncode编码；
各个参数请进行URL 编码(UTF-8)，编码时请遵守 RFC 1738

中文传参示例
1. url直接传参 encodeURI(encodeURI(URIstring))

 http://localhost:8080/StandardApiAction_marginGroup.action?value=encodeURI(encodeURI(URIstring))

ajax的data传参(推荐) encodeURI(URIstring)

    var data = {}
    data.value = encodeURI(URIstring)
    $.ajax({
             url: 'http://localhost:8080/StandardApiAction_marginGroup.action
            data: data,
            cache:false,
            dataType:'json',
            success: function (json) {
               if(json.result == 0){
                  alert('Success');
               } else {
                  alert('Failure');
               }
            },error:function(XMLHttpRequest, textStatus, errorThrown){
            }
    });

3.HTTP MIME 类型

JSON
Content-type: application/json;charset=utf-8
JSONP
Content-type: text/javascript; charset=utf-8

4.JSONP调用示例

第三方通过JS调用Open API时可以通过指定callback参数来要求平台端返回JSONP代码，以解决跨域问题。
callback参数值只能是字母数字下划线

$.ajax({
    type:'POST',
    url: 'http://localhost:8080/StandardApiAction_loginEx.action?callback=getData',
    data: data,
    cache:false,
    dataType:'JSONP',
    success: getData=function (data) {
        if(data.result == 0){
            alert('Success');
        } else {
            alert('Failure');
        }
    },
});