创建应用

了解 SHOPLINE 应用的分发方式后,你可以开始按照需要的场景创建应用。在正式配置之前,你需要通过本文档了解三种分发方式的完整处理流程,以便你知道创建的应用目前处于哪一个阶段。


你将会学到什么

  • 3种应用的创建流程

字段定义

字段名称说明
应用名称应用名称将显示在开发者中心列表,以帮助你快速识别你的应用。注:应用市场展示的名称需在“应用详情”中设置。
应用地址在应用安装过程需使用,当商家安装你的应用或进入应用时,你的应用将收到对此应用地址的 GET 请求。
回调地址商家在 OAuth 过程中授予应用权限后,商家将被重定向的 URL,平台将通过此 URL 通知应用已在平台被安装完成,并把临时 OAuth Code 回传到此 URL。

创建公共应用

STEP 1 创建新应用

在开始接入之前,你需要在 开发者中心 创建新应用并获取 APP KeyAPP Secret,这两个参数在后续获取授权中是必需的。

image.png

基本配置信息填写完成后,可以开始接入授权。 配置公共应用的细节参见:如何在开发者中心配置公共应用配置

STEP 2 接入授权

应用通过 OPEN API 来获取店铺的数据读取或写入权限,而可调用的 API 则取决于安装时向店铺申请的授权内容。需要申请授权的数据内容由应用指定,权限点以及每个权限对应的接口可以参见:权限点列表 在店铺安装应用时,平台会提示商家查看当前应用申请的权限,商家可以判断应用申请的权限是否合理。同时,当一个应用获取授权的范围超过其实际需要的范围时,也可能影响到最终的审核结果。授权接入方式参见文档:授权机制

image.png

STEP 3 使用开发商店进行测试

完成授权后应用就可以调用 API 来获取店铺数据。但是在正式上线之前,还需要用开发商店对应用进行验证,确定它跟平台进行交互的效果与预期一致。 开发商店的使用说明参见:使用开发商店

image.png

STEP 4 提交上线审核

测试通过后,可以申请正式上线。进入到应用详情页,找到提交按钮。提交申请后,平台会在1~2个工作日完成上线审核(支付应用因为验证流程较长,会在3~5个工作日完成)。

导航2.jpg

可见性2.jpg

在提交之前,可以参照 应用审核要求 确定应用已经满足平台要求的所有规则。

创建自定义应用

STEP 1 创建新应用

在开发者中心创建的时候,除公共应用以外,也可以创建自定义应用。自定义应用的配置方法参见:自定义应用配置说明 不同于在商店后台创建的自定义应用,在开发者中心创建的自定义应用,可以在同一个商家的多个店铺进行安装,而不需要每个店铺单独配置。

image.png

STEP 2 接入授权

开发者中心创建的自定义应用同样使用 OAuth 2.0 的授权方式,在调用 API 之前,应用需要按照 授权机制 的方法获取Access Token。

STEP 3 使用开发商店进行测试

同样的,在把应用交付给商家之前,你应该 使用开发商店 完成测试,确保应用已经能够正确地跟平台进行数据交互。 自定义应用不需要审核,但如果商家反馈应用存在质量问题,并且双方沟通未能达成一致的情况下。平台会介入判断并执行下一步的处理。

创建私有应用

STEP 1 创建新应用

不同于前两种分发方式,这是完全基于商家管理的一种应用创建方案。因为它是商家主动创建的应用,相比另外两种方式,省略了获取授权的步骤,同时商家还可以实时地控制应用可以访问的接口权限。 进入店铺管理后台应用 模块,通过 开发应用 入口,可以进入到私有应用的管理页面。具体的配置方法,参见:私有应用配置说明

STEP 2 获取授权

私有应用的授权方式比较简单,只需要在后台配置好应用需要访问的权限,并使用商家或管理员账号获取到访问令牌,就可以正常调用 SHOPLINE 提供的 Open API。

image.png

STEP 3 使用 Token

tip

因为在获取令牌的时候,你已经完成应用安装;这个时候使用 Token 调用 API 获取/操作的数据都是店铺的真实数据,所以需要谨慎操作,避免对店铺实际运营产生影响。

当然,你同样也可以申请一个开发者中心账号,从而创建一个测试店铺用于验证你的应用。在一切准备好之后,回到真实店铺创建并安装这个应用。

这篇文章对你有帮助吗?