接口鉴权说明 - CFT-周大福

Chapter 1. 对接数云openapi步骤

环境信息	请求域名	接口服务名（contextPath）	服务版本	接口验签（serviceName）	接口验签（serviceSecret）	备注
测试环境	https://api-vpjq75s2e4.kylin.shuyun.com	fast-service	v1	dataapi	222sdada234g
生产环境						上线前提供

对接者先向数云申请serviceName和serviceSecret
serviceName: 接口调用服务的身份标识，是一个固定的字符串常量，请向数云申请
serviceSecret：接口调用服务的身份密钥，请向数云申请。为确保安全，请妥善保管，不可泄露。

对接者根据API定义编写客户端程序，可以使用任何技术语言编写。

对接者与数云数据服务端进行接口联调，直至调试通过。

Chapter 2. 接口设计

接口url: /{contextPath}/{version}{requestPath}
其中：
1）contextPath 是被调用服务的名称；
2）version 是被调用服务的版本信息；
3）requestPath是调用服务的请求路径。

示例如下：
url: api.xxx.com/fast-service/v1/0.0/wechat/member?memberId=5314115615&memberType=tcbj
contextPath: fast-service
version: v1
requestPath: /0.0/wechat/member

Chapter 3. 公共请求消息头

1.所有请求头都必须包含 X-Caller-Service、 X-Caller-Timestamp、 X-Caller-Sign、 Content-Type

2.说明

请求头(Header)	说明
X-Caller-Service	对应上文中的serviceName
X-Caller-Timestamp	时间戳.格式:yyyy-MM-dd HH:mm:ss,时区为GMT+8.如：2015-01-01 12:20:11
X-Caller-Sign	签名. 参考sign安全校验机制
Content-Type	只支持JSON格式. application/json; charset=utf-8

Chapter 4. sign安全校验机制

1.各个服务通过gateway进行调用的时候，需要增加三个自定义的头信息：X-Caller-Service、XCaller-Timestamp、X-Caller-Sign.

2.X-CallerSign是通过callerService、timestamp、contextPath、version、serviceSecret、restPath,按首字母排序后,进行md5加密获得的值，只需要将对应的名字做修改即可.
Java版本代码如下：