帮助中心

EZR开放平台开发指南

2020-07-29

接入指南

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

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

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

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


数据请求路径

测试环境: http://test.ezrpro.com:8085

Q1数据中心:  http://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


21138