对接约定

接入方式

发票云API采用RESTfull的设计方式，客户端通过HTTP协议的GET、POST(目前主要是这两种)方法请求进行调用。

Restful：参考资料
http://www.infoq.com/cn/articles/designing-restful-http-apps-roth

API的调用地址基本上遵循如下约定的方式： API地址前缀 + 服务 + 资源 + 参数

环境地址

私有化环境: baseUrl = {现场部署影像系统的ip或域名:现场部署影像系统的端口}

测试环境: baseUrl = https://api-dev.piaozone.com/test

正式环境: baseUrl = https://api.piaozone.com

认证方式

对接过程中需要：

• 发票云授权标识（client_id）
• 授权密钥（client_secret）
• 加密密钥（encrypt_key）

client_id和client_secret用于授权认证：获取AccessToken(影像系统)
encrypt_key用于报文加密。
每个环境的授权不同，获取方式可以找实施人员协助提供。如果是金蝶机构的同事，也可以直接通过智能审批获取，审批流名称如下：

签名规则

支持以下签名生成方式：
1、MD5代码示例：

MD5(client_id + client_secret + timestamp)
如：
String client_id = "发票云激活时提供的client_id";
String client_secret = "发票云激活时提供的client_secret";
long times = System.currentTimeMillis();
String checkSign = MD5.md5crypt(client_id + client_secret + timestamp);

接口返回约定： 若无特别说明，接口返回如下

{
    "errcode": "0000", ///成功时为0000, 失败时为非0000
    "description": "操作成功", //描述，失败时可以根据这个字段进行提示
    "data": "" //请求的返回实际数据
}