商家接入有赞云完整流程(自用型)

需求背景:

商家在有赞开店,商家拥有自己的业务中台系统(第三方系统或自行开发的系统),希望通过技术实现,将相应的功能和数据统一维护到自己的业务中台系统中方便管理。

使用场景:

有赞云提供一套标准化流程的 API 接口供商家的技术人员接入。商家可按照实际的业务需求接入相应功能的 API 接口。

对接流程

image.png

1. 创建店铺。

详情可参考帖子:如何创建店铺

2. 有赞云应用平台开发者帐号注册。

详情可参考帖子:有赞云开发者帐号注册流程。提交申请后请耐心等待,审核周期一般保证 1~3 个工作日内解决,节假日顺延,审批速度与审批量有关。
注:注册完成绑定的邮箱不支持更改,请注册人员在注册期间使用长期可用的邮箱。
其他认证过程常见问题请点击

3. 添加开发者帐号为店铺员工

1.登陆店铺

2. 点击设置 -> 点击店铺设置 -> 点击员工管理 -> 点击添加员工

注:添加的开发者帐号最低权限为普通管理员

image.png

4. 创建应用并授权绑定店铺

创建应用前请仔细阅读应用分类说明,商家按照实际要接入的需求选择创建对应的应用并授权绑定使用的店铺。
注:对接期间店铺产生的数据不支持删除。如果商家不想测试的脏数据混在正式店铺中可登陆应用后台申请测试店铺进行对接,等接口功能接入测试验收完毕再切换到正式店铺上。

PS:创建应用授权店铺必须是正式店铺,具体可点击授权流程详情说明

image.png

具体流程请参考如下说明:
自用型无容器
自用型有容器

:若商家想用自用型无容器应用进行对接,请先参考有赞云自用型无容器应用创建审核规范。应用创建成功后是待审核状态,审核会有相关工作人员进行处理,审核周期一般保证 3~5 个工作日内解决,节假日顺延,审批速度与审批量有关,请耐心等待。

5. 登陆应用后台获取 client_id、client_secret、kdt_id(店铺 Id)生成调用 API 接口所需的 token 值

client_id、client_secret 获取参考
kdt_id(店铺 Id)获取参考

不同应用生成 token(7 天内有效)的调用方式不同,商家按照实际创建的应用使用对应的方式调用生成 token(7 天内有效),支持 HTTP 和 SDK 两种方式。

具体请参考如下文档说明:
SDK 方式生成说明
HTTP 方式生成说明

以自用型无容器为例

SDK 方式调用:
image.png

HTTP 方式调用(Postman 工具示例):
image.png

6. 操作店铺生成相关数据

商家可在店铺里创建商品,下单等操作在店铺中产生相应的数据。若操作过程中遇到不理解功能点可通过以下方式解决:
1. 点击店铺页面右上角帮助中心搜索相关问题答案。
2. 若帮助中心无法解决可在店铺页面右边找到有赞服务窗口点击在线客服进线咨询。
image.png

7. 调用 API 接口获取数据

商家根据实际的业务场景调用相应的 API 接口获取数据。
接口文档列表请点击

Postman 调用示例:
image.png

注一:接入接口的字段参数类型请严格按照文档定义的格式传参。若调用接口出错可在文档中心搜索相应的问题参考排查方法。
注二:调用接口返回无权限错误这是接口没有开通调用权限,详情请参考帖子:有赞云 API 接口申请指南

image.png

若文档中心无法解决可登陆有赞云应用后台提交工单提问咨询。

image.png

8. 商家进行后续的业务逻辑处理