应用快速构建指南
Genstore 生态应用 是平台的核心扩展机制，赋能开发者构建自定义解决方案，为商家提供专业化的业务扩展，实现商业价值最大化。以下指南将帮助您快速上手开发和部署应用。我们希望与全球开发者携手合作，构建一个充满活力且富有长远生命力的开放生态系统。通过多样化的应用形式，我们不仅帮助商家提升服务质量和购物体验，还为开发者提供全方位的支持，包括政策引导、技术工具和优化流程。
应用生态
Genstore 应用大多由第三方开发者构建，部分应用由 Genstore 官方团队开发。开发者可以利用 Genstore 开放的 API 和开发工具，开发出全新的扩展功能，或与外部服务实现无缝集成，从而为商家带来更高效的运营体验。更多信息，可阅读 什么是 Genstore 应用。
开发准备
在开始开发之前，请确保您已了解 Genstore 应用集成指南。
应用类型
| 应用类型 | 描述 | 特点 |
|---|---|---|
| Public Apps（公共应用） | 经过 Genstore 官方审核并发布在 应用商店 上的应用，任何 Genstore 商家都可以搜索、查看和安装。 | • 在合作伙伴面板创建 • 需要应用审核 • 通过应用商店安装 |
| Custom Apps（自定义应用） | 自定义应用可以为您的 Genstore 后台添加专属功能，专为您的商店量身定制，且不会在 Genstore 应用商店中显示。 | • 在 Genstore Admin 后台创建 • 不列入 Genstore 应用商店 • 无需应用审核 • 通过开发者提供链接安装 |
公共应用
STEP 1：创建应用
- 登录 Genstore 合作伙伴中心，点击左侧导航栏中的 应用 模块，进入应用管理页面，点击 创建应用 按钮。
- 填写 应用名称：此名称仅供开发者内部参考，应用提审时可单独配置在应用市场中展示的名称。
STEP 2：配置基础信息
完成应用的初始化后，应用将出现在应用列表中，点击应用名称进入可应用 概览 页，获取应用详情。
在应用的 应用配置 页面，您可完成应用的初始设置，如名称、地址、应用打开方式，Webhook 相关设定，应用导航，联系信息以及 Logo。具体可阅读 应用配置。
STEP 3：开发与测试应用
完成基础信息配置后，即可进行开发与调试。测试应用前，请确保应用功能符合商家需求且正常运行。
- 点击应用名称进入可应用 概览 页。
- 在 应用测试 部分，关联测试店铺。若无正式商店环境，可使用 Genstore 提供的开发商店 进行测试。
- 安装应用并开始调试，确保各功能稳定可靠。
STEP 4：提交上架申请
经过充分测试后，可提交应用上架并设置市场展示信息。Genstore 目前支持 公有发布 方式，即所有店铺都可在应用市场查找并安装应用，不限制安装次数。
通过以上步骤，您将能够成功创建并上线 Genstore 应用，为商家提供专业服务和价值。如有任何疑问，请随时联系开发者支持团队。
自定义应用
权限准备
您可邀请协作者或员工创建、编辑或删除自定义应用，并授予开发权限及相关 API 范围设置权限。
创建角色权限
- 登录 Genstore 商户后台。
- 导航至 设置 -> 账号权限。
- 点击 管理角色。
- 在新窗口中，点击 新建角色。
- 填写角色 标题 和 描述，如
自定义应用开发。 - 在 店铺权限 部分，勾选 应用开发
- 点击 保存。
向用户分配角色
完全权限的创建后，您可以为协作者或员工分配该角色。
- 登录 Genstore 商户后台，导航至 设置 -> 账号权限。
- 在 员工 列表中选择要分配角色的用户，点击 ... -> 编辑。
- 在员工详情中，选中 刚刚创建的
自定义应用开发权限。 - 点击 保存。
创建自定义应用
完成角色的创建和分配后，您可开始应用的开发工作，注意：仅店主或拥有 开发自定义应用 权限的员工可进行自定义应用开发。
- 在 Genstore 商户后台，点击 应用 -> 开发应用。
- 在新窗口中，点击 创建应用，并填写以下信息：
- 应用名称：自定义应用名称
- 应用开发者：选择店主/有权限的员工账户
- 点击 保存。
配置自定义应用
配置 API 访问范围
在安装应用之前，您需要设置 API 访问范围。
- 在 Genstore 商户后台，点击 应用 -> 开发应用。
- 在应用列表中，点击目标应用进入应用详情页。
- 在 概览 页签，点击 配置 API 访问范围。在随即打开的 应用配置 页面，点击 编辑。
- 勾选所需权限范围（如订单读取、产品管理等）。
- 点击 保存。
安装应用
在安装应用之前，您需要先获取 API 凭证。
- 在 Genstore 商户后台，点击 应用 -> 开发应用。
- 在应用列表中，点击目标应用进入应用详情页。
- 点击 安装应用 按钮，确认安装。
- 系统将生成 Access Token，请立即保存该令牌。重要：
Access Token仅首次可见，请务必保存。
密钥管理
- 在 Genstore 商户后台，点击 应用 -> 开发应用。
- 在应用列表中，点击目标应用进入应用详情页。
- 点击 管理 API 凭证 按钮或 API 凭证 页签，查看：
API KeyAPI SecretAPI Access token（仅首次安装可见，建议查看后保存）
应用维护
更新 API 范围
- 在 Genstore 商户后台，点击 应用 -> 开发应用。
- 在应用列表中，点击目标应用进入应用详情页。
- 您可在 应用配置 页签查看当前应用的 API 访问范围。
- 点击 编辑 修改权限范围。注意： 修改 API 范围时，已安装应用必须保留至少一个权限。
- 点击 保存。
修改基本信息
- 在 Genstore 商户后台，点击 应用 -> 开发应用。
- 在应用列表中，点击目标应用进入应用详情页。
- 您可在 应用设置 页签修改：
- 应用名称/描述
- 主要开发者（员工账户删除后自动转给店主）
- 开发更新通知邮箱（可选）
修改完成后，点击 保存。
卸载与删除应用
卸载应用
- 在 Genstore 商户后台，点击 应用 -> 开发应用。
- 在应用列表中，点击目标应用进入应用详情页。
- 点击 卸载应用。
- 系统将自动撤销 API Token 并删除 Webhooks。
永久删除
删除前，请确保应用已卸载。
- 在 Genstore 商户后台，点击 应用 -> 开发应用。
- 在应用列表中，点击目标应用进入应用详情页。
- 进入 应用设置 -> 删除应用。
- 确认删除操作，所有相关数据将被同步删除。注意：删除操作不可逆，请谨慎操作。