同徽开放平台

同徽开放平台

背景说明

同徽企业开放平台，旨在协助具有供应链对接需求的企业，方便快捷的构建体系内的供应链数据链路流通，进而完成企业的信息化发展。

为了便于合作企业理解以及快速对接徽企业开放平台的功能和服务，同徽将向企业提供相关示例

阅读对象

1. 接入同徽企业开放平台的合作平台体系中的产品人员和研发人员；
2. 本文档主要支持Java语言的接入

文档约定

1. 以下的描述中，“开放平台”约定指：同徽企业开放平台；“合作平台”约定指：接入同徽企业开放平台的外部企业
2. 开放平台接入使用的开发语言为JAVA
3. 接入过程中，涉及到字符编码相关的操作，统一默认使用“UTF-8”。
4. 开放平台接口服务协议约定为https
5. 名词定义和简称

名词	含义	英文	备注
平台ID	合作平台在开放平台的唯一标识	Key	BBC为平台分配
秘钥	合作平台在开放平台的秘钥	SecretKey	BBC为平台分配

1. 接入过程中包含以下几种形式：

报文： 提供接口，合作平台可以通过接口进行相应的请求处理操作。

产品整体说明

申请说明

由合作平台向开放平台申请对接请求，开放平台开通合作平台账户体系及相关接口授权后，合作平台可登录开发平台地址查看授权的接口列表及详细，授权后的接口将在开发平台持续发布。

流程图

加验签

请求参数(http请求头Headers)

名称	类型	是否必填	描述
Token	String	是	验证加密值 Md5(appKey+Timespan+SecretKey) 加密的32位大写字符串)
Timespan	String	是	精确到秒的Unix时间戳
App-Key	String	是	应用APPKEY

String appKey = "RUMWIHKXZ8Q6Bnr7wqlkv4PtYzJaCdgF";
String secretKey = "ZOd1yseq9oCRNDM6h0GzHpS4vbQuYmixPgrcBtaEKj7lU";
long timespan = System.currentTimeMillis();
log.info(timespan+"");
String token = SecureUtil.md5(appKey + timespan + secretKey).toUpperCase();
log.info(token);

统一说明

参数统一命名

名称	类型	是否必填	描述
Token	String	是	验证加密值 Md5(appKey+Timespan+SecretKey) 加密的32位大写字符串)
Timespan	String	是	精确到秒的Unix时间戳
App-Key	String	是	应用APPKEY

响应码

错误码	错误描述
0	操作成功
40002	请求操作失败
40003	没有找到对应信息
40004	不合法参数
50001	系统错误
50002	会话超时
90012	解密失败
90013	密钥为空