创建应用
了解 SHOPLINE 应用的分发方式后,你可以开始按照需要的场景创建应用。在正式配置之前,你需要通过本文档了解三种分发方式的完整处理流程,以便你知道创建的应用目前处于哪一个阶段。
你将会学到什么
- 3种应用的创建流程
字段定义
字段名称 | 说明 |
---|---|
应用名称 | 应用名称将显示在开发者中心列表,以帮助你快速识别你的应用。注:应用市场展示的名称需在“应用详情”中设置。 |
应用地址 | 在应用安装过程需使用,当商家安装你的应用或进入应用时,你的应用将收到对此应用地址的 GET 请求。 |
回调地址 | 商家在 OAuth 过程中授予应用权限后,商家将被重定向的 URL,平台将通过此 URL 通知应用已在平台被安装完成,并把临时 OAuth Code 回传到此 URL。 |
创建公共应用
STEP 1 创建新应用
在开始接入之前,你需要在 开发者中心 创建新应用并获取 APP Key
和 APP Secret
,这两个参数在后续获取授权中是必需的。
基本配置信息填写完成后,可以开始接入授权。 配置公共应用的细节参见:如何在开发者中心配置公共应用配置
STEP 2 接入授权
应用通过 OPEN API 来获取店铺的数据读取或写入权限,而可调用的 API 则取决于安装时向店铺申请的授权内容。需要申请授权的数据内容由应用指定,权限点以及每个权限对应的接口可以参见:权限点列表 在店铺安装应用时,平台会提示商家查看当前应用申请的权限,商家可以判断应用申请的权限是否合理。同时,当一个应用获取授权的范围超过其实际需要的范围时,也可能影响到最终的审核结果。授权接入方式参见文档:授权机制
STEP 3 使用开发商店进行测试
完成授权后应用就可以调用 API 来获取店铺数据。但是在正式上线之前,还需要用开发商店对应用进行验证,确定它跟平台进行交互的效果与预期一致。 开发商店的使用说明参见:使用开发商店
STEP 4 提交上线审核
测试通过后,可以申请正式上线。进入到应用详情页,找到提交按钮。提交申请后,平台会在1~2个工作日完成上线审核(支付应用因为验证流程较长,会在3~5个工作日完成)。
在提交之前,可以参照 应用审核要求 确定应用已经满足平台要求的所有规则。
创建自定义应用
STEP 1 创建新应用
在开发者中心创建的时候,除公共应用以外,也可以创建自定义应用。自定义应用的配置方法参见:自定义应用配置说明 不同于在商店后台创建的自定义应用,在开发者中心创建的自定义应用,可以在同一个商家的多个店铺进行安装,而不需要每个店铺单独配置。
STEP 2 接入授权
开发者中心创建的自定义应用同样使用 OAuth 2.0 的授权方式,在调用 API 之前,应用需要按照 授权机制 的方法获取Access Token。
STEP 3 使用开发商店进行测试
同样的,在把应用交付给商家之前,你应该 使用开发商店 完成测试,确保应用已经能够正确地跟平台进行数据交互。 自定义应用不需要审核,但如果商家反馈应用存在质量问题,并且双方沟通未能达成一致的情况下。平台会介入判断并执行下一步的处理。
创建私有应用
STEP 1 创建新应用
不同于前两种分发方式,这是完全基于商家管理的一种应用创建方案。因为它是商家主动创建的应用,相比另外两种方式,省略了获取授权的步骤,同时商家还可以实时地控制应用可以访问的接口权限。
进入店铺管理后台 的 应用
模块,通过 开发应用
入口,可以进入到私有应用的管理页面。具体的配置方法,参见:私有应用配置说明
STEP 2 获取授权
私有应用的授权方式比较简单,只需要在后台配置好应用需要访问的权限,并使用商家或管理员账号获取到访问令牌,就可以正常调用 SHOPLINE 提供的 Open API。
STEP 3 使用 Token
因为在获取令牌的时候,你已经完成应用安装;这个时候使用 Token 调用 API 获取/操作的数据都是店铺的真实数据,所以需要谨慎操作,避免对店铺实际运营产生影响。
当然,你同样也可以申请一个开发者中心账号,从而创建一个测试店铺用于验证你的应用。在一切准备好之后,回到真实店铺创建并安装这个应用。