自定义应用配置说明​

除了公共应用，你还可以在开发者中心创建自定义应用，自定义应用是使用单商家安装链接方式进行分发的，它不需要上架到应用市场，所以也不需要经过平台的审核。通常用于为单个商家定制应用的场景。

你将学到什么​

• 自定义应用的详细配置方法
• 商家如何安装你提供的自定义应用

在此之前你可能需要了解​

• SHOPLINE 应用的分发方式
• 创建应用的流程

STEP 1 创建应用​

1. 进入开发者中心“应用”模块，点击“创建应用”按钮

2. 选择“自定义应用”并填写基本信息

• 应用名称：不同于公共应用，基础信息填写的应用名称会展示在商家侧。
• 应用地址：应用的运行地址，商家在平台进入应用时，SHOPLINE 回跳转到这个地址。
• 应用回调地址：用于接收平台的回调，比如请求授权时，SHOPLINE 会携带参数回调到这个地址。
  • 当你需要在不同的应用环境接收回调进行测试时，你可以配置多个回调地址。
  • 配置多个回调地址的情况下，需要在请求参数中指定接收回调地址。

STEP 2 完成基础配置​

1. 点击创建好的应用，进入应用配置面板；选择“应用设置”

2. 应用打开方式：

   • 内嵌：以 iframe 加载方式在商店管理后台打开，商家不需要跳离 SHOPLINE 管理后台，具备更优秀的使用体验。选择内嵌方式，需要接入平台提供的 App Bridge 能力。
   • 外跳：在浏览器打开新标签页运行应用。

3. 应用联系人：SHOPLINE 在发布重大消息时，将会通过该联系方式与你联系，请保证联系人信息准确并有效。

STEP 3 完成可用店铺名单配置​

1. 点击“商家使用”进入到商家名单配置页面

2. 设置应用的基础信息

• 应用描述：可简要概括应用的作用，便于商家日常使用管理。
• 应用logo：在应用市场展示的图标，需要满足120*120的规格。

3. 商家店铺handle

• 自定义应用是为单个商家创建的应用，允许被同一个商家的多个店铺安装，但不能被多个商家安装。所以这里填写的handle，只能来自于同一个商家。

STEP 4 订阅 webhook 事件​

事件订阅并不是必须的，但是合理利用订阅事件可以让你的应用数据跟 SHOPLINE 保持同步。商店发生特定事件的之后，平台会触发 Webhook 通知，将消息发送给被店铺安装且订阅了该事件的应用。 你可以在开发者中心管理你订阅的内容：

STEP 5 拼接授权地址给到商家​

1. 按照以下格式拼接授权地址。
2. 将地址给到已经配置在可用名单中的店铺。
3. 商家登录店铺后，在浏览器贴入授权地址并运行，即可完成安装。

https://{handle}.myshopline.com/admin/oauth-web/#/oauth/authorize?appKey=******&responseType=code&scope=*******&redirectUri=*******）

链接说明：

• handle：店铺的唯一标识。
• appkey：创建应用时生成，在应用管理页面可以查阅。
• responseType：返回类型，固定值=code。
• scope：需要店铺授权的权限点，多个权限点时每个权限点间通过半角逗号“,”分隔。接口和权限的关联关系可以参见：权限点列表。
• redirectUri：授权后重定向的地址，可以是应用内的任意页面。

后续动作​

• 如何使用开发商店测试应用
• 设置网站导航，让你的应用更方便使用