--- title: "自定义应用配置说明" doc_type: static doc_category: static doc_version: v20270301 source_url: html: 'https://developer.shopline.com/zh-hans-cn/docs/apps/application-management/creating-a-custom-application' md: 'https://developer.shopline.com/zh-hans-cn/docs/apps/application-management/creating-a-custom-application.md' --- # 自定义应用配置说明 除了公共应用，你还可以在开发者中心创建自定义应用，自定义应用是使用单商家安装链接方式进行分发的，它不需要上架到应用市场，所以也不需要经过平台的审核。通常用于为单个商家定制应用的场景。 ## 你将学到什么 - 自定义应用的详细配置方法 - 商家如何安装你提供的自定义应用 --- ## 在此之前你可能需要了解 - SHOPLINE 应用的分发方式 - 创建应用的流程 --- ## STEP 1 创建应用 1. 进入开发者中心“应用”模块，点击“创建应用”按钮 ![image.png](https://s2cdn.myshopline.com/slfs/op-new/171956832263595/image.png) 2. 选择“自定义应用”并填写基本信息 - 应用名称：不同于公共应用，基础信息填写的应用名称会展示在商家侧。 - 应用地址：应用的运行地址，商家在平台进入应用时，SHOPLINE 回跳转到这个地址。 - 应用回调地址：用于接收平台的回调，比如请求授权时，SHOPLINE 会携带参数回调到这个地址。 - 当你需要在不同的应用环境接收回调进行测试时，你可以配置多个回调地址。 - 配置多个回调地址的情况下，需要在请求参数中指定接收回调地址。 ![image.png](https://s2cdn.myshopline.com/slfs/op-new/171956837658074/image.png) ## STEP 2 完成基础配置 1. 点击创建好的应用，进入应用配置面板；选择“应用设置” ![应用设置不贴边.jpg](https://s2cdn.myshopline.com/slfs/op-new/171956984359901/应用设置不贴边.jpg) 2. 应用打开方式： - 内嵌：以 iframe 加载方式在商店管理后台打开，商家不需要跳离 SHOPLINE 管理后台，具备更优秀的使用体验。选择内嵌方式，需要接入平台提供的 App Bridge 能力。 - 外跳：在浏览器打开新标签页运行应用。 3. 应用联系人：SHOPLINE 在发布重大消息时，将会通过该联系方式与你联系，请保证联系人信息准确并有效。 ![应用联系人不贴边.jpg](https://s2cdn.myshopline.com/slfs/op-new/171956968210810/应用联系人不贴边.jpg) ## STEP 3 完成可用店铺名单配置 1. 点击“商家使用”进入到商家名单配置页面 ![商家使用不贴边.jpg](https://s2cdn.myshopline.com/slfs/op-new/171956951664388/商家使用不贴边.jpg) 2. 设置应用的基础信息 - 应用描述：可简要概括应用的作用，便于商家日常使用管理。 - 应用logo：在应用市场展示的图标，需要满足120*120的规格。 3. 商家店铺handle - 自定义应用是为单个商家创建的应用，允许被同一个商家的多个店铺安装，但不能被多个商家安装。所以这里填写的handle，只能来自于同一个商家。 ![店铺hanndle1.jpg](https://s2cdn.myshopline.com/slfs/op-new/171956933270207/店铺hanndle1.jpg) ## STEP 4 订阅 webhook 事件 事件订阅并不是必须的，但是合理利用订阅事件可以让你的应用数据跟 SHOPLINE 保持同步。商店发生特定事件的之后，平台会触发 Webhook 通知，将消息发送给被店铺安装且订阅了该事件的应用。 你可以在开发者中心管理你订阅的内容： ![7创建自定义应用.jpg](https://s2cdn.myshopline.com/slfs/op-new/170387544652765/7创建自定义应用.jpg) ## STEP 5 拼接授权地址给到商家 1. 按照以下格式拼接授权地址。 2. 将地址给到已经配置在可用名单中的店铺。 3. 商家登录店铺后，在浏览器贴入授权地址并运行，即可完成安装。 ```http https://{handle}.myshopline.com/admin/oauth-web/#/oauth/authorize?appKey=******&responseType=code&scope=*******&redirectUri=*******） ``` 链接说明： - handle：店铺的唯一标识。 - appkey：创建应用时生成，在应用管理页面可以查阅。 - responseType：返回类型，固定值=code。 - scope：需要店铺授权的权限点，多个权限点时每个权限点间通过半角逗号“,”分隔。接口和权限的关联关系可以参见：[权限点列表](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/access-scope.md)。 - redirectUri：授权后重定向的地址，可以是应用内的任意页面。 ## 后续动作 - [如何使用开发商店测试应用](https://developer.shopline.com/zh-hans-cn/docs/apps/application-management/creating-an-app.md) - [设置网站导航，让你的应用更方便使用](https://developer.shopline.com/zh-hans-cn/docs/apps/application-extension/site-navigation.md)