华阳获取盒子数据&商圈(1).docxVIP

  1. 1、本文档共18页,可阅读全部内容。
  2. 2、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
  3. 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载
  4. 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
  5. 5、该文档为VIP文档,如果想要下载,成为VIP会员后,下载免费。
  6. 6、成为VIP后,下载本文档将扣除1次下载权益。下载后,不支持退款、换文档。如有疑问请联系我们
  7. 7、成为VIP后,您将拥有八大权益,权益包括:VIP文档下载权益、阅读免打扰、文档格式转换、高级专利检索、专属身份标志、高级客服、多端互通、版权登记。
  8. 8、VIP文档为合作方或网友上传,每下载1次, 网站将根据用户上传文档的质量评分、类型等,对文档贡献者给予高额补贴、流量扶持。如果你也想贡献VIP文档。上传文档
查看更多
erp接口服务说明 总体说明 接口提供方式:接口以HTTP的方式提供。 数据格式:ERP中间件响应的数据统一为JSON格式。 编码:UTF-8 HTTP method:全部接口都以POST方式提供。 接口地址: /rest/**** 每日访问次数限制:50000 准备步骤 申请成为华阳的开发者。 申请通过审核之后,会收到邮件,如下图: 请记录其中的appKey和appSecret。 登录,进入开发者中心,添加一个应用场景,注意要勾选其中的“ERP对接选项”,“登录地址”应填写为: 创建完成之后,从页面中可以看到应用ID,请将其复制并记录: 进入首页中,可以在“我的定制”中看到ERP,进入之后可以做ERP相关的设置。 目前可以实现线下门店跟线上门店的关联: 具体操作方式请参考《ERP系统门店关联操作手册》。 准备工作完成。下面可以进行后台接口调用。 接口调用 所有的接口都以http post方式提供。ERP中间件响应的内容为json格式,UTF-8编码,参数应以http parameter的方式传送给ERP中间件。 一个正常的响应示例: {"result":{"accessToken":"glZbo+zFsQ1678SeCleO9PdBCww=","expiresIn":7200},"success":true} 一个异常的响应示例: {"exceptionInfo":{"exceptionMessage":"未找到对应的订单","exceptionType":"未找到对象","exception":"ObjectNotFoundException"},"success":false} 其中,success字段表示接口是否调用成功,成功时值为true,失败时值为false。当成功时,响应中会包含result字段,这个字段是业务接口的返回值。当失败时,响应中会包含exceptionInfo字段,可以根据exceptionInfo来判断错误的类型,有助于调整您的程序代码。 其中的accessToken就是获取到的accessToken,请在你的服务器中缓存这个值,并在调用每个业务接口时都加上这个参数。expiresIn是指accessToken的有效时间(秒),有效时间内不需要重复获取accessToken。过期之后,需要重新获取。 exceptionInfo中的exception字段表示了异常的类型(可以理解为错误代码),目前常见的有以下几种: AccessExceedException:接口访问次数超出限额 AccessTokenInvalidException:无效的AccessToken AccessTokenNotFountException:未获取AccessToken MethodNotAllowedException:HTTP METHOD错误 ObjectNotFoundException:未找到对象 ParameterBindingException:参数绑定错误 ParameterExceedException:参数超出范围 ParameterEmptyException:参数空错误 ParameterTypeMismatchException:参数类型错误 PermissionRefusedException:越权操作 UncategorizedException:未分类的异常 如果出现的异常不在上述分类当中,则可能是ERP中间件内部发生了异常,请联系华阳信通公司。 备注: 每个接口、每个商家、每天的访问次数一般为50000次(个别除外,详见接口文档),超限额的请求不会被接受,系统会给出AccessExceedException。 请注意并非所有情况下都会保证按上述内容响应(比如断网、ERP中间件正在维护、或者域名解析错误等)。请在编写代码时妥善处理。推荐使用HTTP状态码做额外判断。 接口在后续有扩展的可能。有可能新增字段等。请妥善处理您的程序,应当仅处理您需要的字段。 基本的参数及返回值的类型: String:字符串。 int\Integer:整型数字。如果没有特别说明,一般应当大于或等于0。 Double:浮点型数字。如果没有特别说明,一般应当大于或等于0。 Boolean:布尔型。true或false Date:日期型。实际接口中以String型代替,格式为yyyy-MM-dd HH:mm:ss 智慧商圈分页获取账单信息 接口请求说明 调用地址 接口地址/rest/boxCircle/findBills 方法描述 分页获取账单信息,每日访问次数限制为50000次 请求参数描述 参数 名称 类型 允许为空 备注 accessToken 唯一凭证 String N pageNumber 第几页 int

文档评论(0)

东山书苑 + 关注
实名认证
文档贡献者

业务以学生学习成长为中心,为外语培训、中小学基础教育、学前教育,提供各种学习资料支持服务。

1亿VIP精品文档

相关文档