开发者门户远程接口调用规范.PDFVIP

神州数码 开发者门户 远程接口调用规范 当前版本： V1.0 神州数码 目录 第一章 通用规范3 1.1 协议3 1.2 appid、appkey 及 version 3 1.3 数字签名3 1.4 请求3 1.5 响应4 1.6 报文规范4 1.7 普通远程接口调用5 1.7.1 请求报文5 1.7.2 响应报文5 1.8 需要鉴权的接口调用6 1.8.1 请求报文6 1.8.2 响应报文6 神州数码 第一章 通用规范 1.1 协议 中心认证服务提供 http(s)协议的远程调用. 系统接收客户端调用并同步返回响应。 1.2 appid 、appkey 及 version 在每次做远程接口调用时，都要用到 appid 和 appkey，其定义如下： 应用标识，用来唯一标识一个应用，通过线下的方式获取，应用注册成功 appid 后，会返回对应的 appid。 appid 构成规则：”csp- “+app 名称+3 位数字。 数字签名密钥，用于在发起请求时对请求报文进行数字签名使用。通过线下 appkey 的方式获取，应用注册成功后，会返回对应的appkey。 appkey 构成规则：48 位随机 hex 字符串 (小写)。 远程接口版本号，由于服务接口处于不断完善的状态中，会尽量保持向前兼 容，但也不可避免的会存在一些不能兼容旧版本的情况，为了保证已有的系 version 统不会因为接口升级而不可用，增加版本号参数，即客户端在发起请求时要 传送 version 字段，指明要请求的服务接口的版本号。默认为 1.0 版。 1.3 数字签名 在每次做远程接口调用时，要对请求报文执行数字签名，服务提供方要验签：  将请求报文中 body 部分的数据转换为 json 字符串。  将 appid 拼接在 json 字符串的头部，即 appid+json 报文。  首先采用 MD5 对拼接好的字符串做加密，然后采用 appkey 对加密后的报文做 3DES 运算得到最终的数字签名字符串。  将签名好的字符串放到请求报文的 head 部分，参数名为 sign。 1.4 请求 A. 请求可以通过 GET 或 POST 方式. 远程服务地址 url 格式为: http(s)://[host]:[port]/[appname]/service/[servicename] 其中:  host:port 为服务器地址和端口.  appname 为应用上下文.  servicename 为服务名. B. 请求的 head 中需包含以下属性: 神州数码 Accept=application/json C. 请求的 body 为 json 格式字符串. 编码为 utf8. js