帮助中心
进入EZR

EZR开放平台开发指南

2021-12-16

接入指南

接入EZR开放平台开发，开发者需要按照如下步骤完成：

  1. 申请商家代码和接口接入Token、以及请求IP地址。

  2. 开放平台会分配接入的AppID。

  3. 按照接口文档实现业务逻辑。

  4. 接口属性名不区分大小写。


数据请求路径

测试环境: https://open-dev.ezrpro.com

Q1数据中心:  https://open-q1.ezrpro.com


正式环境：推荐https （具体所在数据中心请咨询客户经理）

Ucloud数据中心：http://open-up.ezrpro.com  或者 https://open-up.ezrpro.com

Azure数据中心（东区1）：  http://open-ap.ezrpro.com 或者 https://open-ap.ezrpro.com

Azure数据中心（东区2）：http://open-ap2.ezrpro.com  或者 https://open-ap2.ezrpro.com

腾讯云数据中心：http://open-tp.ezrpro.com  或者 https://open-tp.ezrpro.com


关于接口并发数

正式环境，按appSystem，每接口每秒并发数上限默认为10，具体上限请咨询客户经理


数据请求格式介绍

"AppId": "ezp",
"Timestamp": "20150622093101",
"Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",
"Args": 见请求参数数据示例(json格式的字符串)，
"AppSystem":"POS"--接通时申请

说明：请求数据实体，描述为单个对象的则只支持单条数据的请求；反之为对象数组则支持批量请求.

1.下面参数在提交驿氪时请使用表单方式提交，保证驿氪可以通过如： Request["Args"]的方式获取，

2.驿氪在做回调时也使用表单方式提交，您可以使用如：Request["Args"]的方式获取，

postman提交截图如下：


字段说明
AppId接入的应用编号，每商家品牌唯一，由平台申请分配
Timestamp

请求时间戳（yyyyMMddHHmmss格式）

服务端会判断请求过期，过期限制为五分钟内

Sign请求签名，详见签名算法
Args请求的数据实体，Json对象（单个对象或对象数组）
AppSystem提交系统

数据返回格式介绍

返回数据结果示例：

{
    "Status": true,
    "StatusCode": 200,
    "Msg": "成功",
    "Timestamp": "20150622093101",
    "Sign": "6ECC9BF07C69E80F6D8552FF7B2E7A8FCA2CC80E",
    "Result": 见业务返回结果示例
}

格式说明：


字段说明
Status结果状态，true代表成功，false代表失败
StatusCode返回操作的状态编码，详见statusCode规范
Msg返回操作的消息描述
Timestamp响应时间戳（yyyyMMddHHmmss格式）
Sign响应签名，详见签名算法
Result返回的数据实体，Json对象（单个对象或对象数组）



EZR开放平台接口特性

接口易用性：本服务的易用性体现在以下方面：

  1. 基于标准的零售业务模式进行建模。API接口简练直观，非常容易理解。在请求、响应的参数中摒弃掉了所有不必要的冗余字段。

  2. API接口响应采用统一的出错代码。

  3. API接口采用标准的RESTful API方式设计，突出对于HTTP协议和浏览器友好性。任何HTTP客户端工具（包括浏览器在内）、编程语言均可轻易调用。

接口安全性：安全性对于接口数据交互来说是至关重要的，本服务的安全性体现在以下方面：

  1. 所有请求都会加盖时间戳。

  2. 所有API接口请求，均会对签名字段做验签；所有API接口响应均带有回传签名。



EZRDemo

dotnet go to samples to download

java go to samples to download


40162