万店掌 开放平台 开放平台对接文档

一、前提

申请成为开发者

      1. 申请认证步骤请参考点击 ✈️
      2. 申请后可以通知销售联系管理员快速审批

接口文档

  开放接口文档地址点击 ✈️

二、接口文档使用指导

    1. 由于开放平台的接口调用,需要用户Token权限校验,所以先介绍获取Token接口。

    2. 从API分类中找到用户组并点击用户登录接口

https://docs.open.ovopark.com/apidoc/detail/12/118/open.shopweb.security.mobileLogin/v1

       

上图: 用户登录API文档详情页,红色框框表示内容标题

 

上图: 业务请求参数和业务返回参数(开发人员重点关注

 

三、沙箱测试接口

沙箱是什么?

      Sandboxie(又叫沙箱、沙盘)即是一个虚拟系统程序,允许你在沙盘环境中模拟调用API, 在代码对接前迅速,快捷的看到效果 !

 

沙箱如何使用?

      这边依然选择用户登录API作为演示

上图: 沙箱入口,在用户登录API文档详情标题右侧

上图 沙箱界面

   用户登录接口沙箱请求示例

Q :这边的请求头怎么没有填写?
A :因为用户登录是获取Token的,无需在请求头添加Token参数

Q: 其他的接口如何使用这里的token?

A:规则
      Key : authenticator
      Value: 从用户登录接口获取的token

      沙箱演示

四、代码请求接口教程

      通过上面的介绍,大家基本了解了开放平台的沙箱服务请求接口,但是在生产环境还是得通过代码去操作的,接下来介绍一下代码调试.

万店掌接口调用工具包

      SDK 是 Software Development Kit 的缩写,翻译过来——软件开发工具包。封装了签名算法等,方便调用万店掌的开放平台所有API 。

工具包的下载位置

https://github.com/ovopark/openplatform-sdk

参数以及方法解释

apigwUrl 网关地址 新网关: http://cloudapi.ovopark.com/m.api
_akey 开发者key (账户中心---->开发者资质查看)
_asid 开发者密码(账户中心---->开发者资质查看)
orgId 账户中心 ---- 企业id
enterpriseId 通过权限API组的接口
“根据组织机构代码获取开发者帐号详细信息
open.gateway.authentication “获取
Class:GwInitRequestHandler 网关初始化请求类
reqHandler.setMethod 设置请求哪个API (每个API的标题)
reqHandler.setParameter 设置请求参数
Class :OvoParkHttpClient HTTP请求客户端
httpClient.setHeaders(); 添加请求头