# 创建应用

> 在开发者后台创建 Shoplazza 公开应用：应用配置、回调地址与权限、上架信息管理，以及四种定价模式的选择。

## 前置需求

你已阅读[应用类型](/docs/app/getting-started/app-types)，并确定要构建公有应用。



Shoplazza 要求公有应用在使用 Shoplazza [Open API](/api/openapi) 资源之前，必须完成 [OAuth 2.0 授权](/docs/app/building-blocks/authentication/oauth-flow)。因此，在应用开发阶段，您需要先创建一个公有应用。

1. 登录您的[合作伙伴账号](https://partners.shoplazza.com/)并进入合作伙伴后台。在左侧面板中选择**"应用"**，然后点击**"创建应用"**按钮。

![](https://cnres.appracle.com/3139a526678860dd886f6fb145a22c87.png)

2. 输入应用名称，然后点击"创建"。

:::note
应用名称是应用实体的代表，是系统在后端处理逻辑中使用的唯一标识符。该名称通常不会显示在应用市场或店铺应用安装列表中。
:::

3. 应用创建后，您的 Client ID 和 Client Secret 将自动生成，可在应用设置页面查看。

![](https://cnres.appracle.com/bf49cf667929faff0508f6decf3769c3.png)

## 应用配置

在开发店铺测试应用之前，您需要在应用配置中添加 **Redirect URL**，以便运行验证来解锁测试功能。

1. 要添加 **Redirect URL**，请点击应用配置下方的"配置"。

![](https://cnres.appracle.com/e90dfe8f66b93f7b0e2405adf10a8a26.png)

2. 在此处您可以添加 **App URL** 和 **Redirect URL**。

![](https://cnres.appracle.com/6007c7e057b2ac57ad322500745dc187.png)

![](https://cnres.appracle.com/eb8dfed34ba0c181dc6bad4c831c9e69.png)

![](https://cnres.appracle.com/c4eaf25120ea1e1fd445b470469bd4ce.png)

**App URL**：主要用于建立互信交互授权 URL。在商家安装应用之前，通过该 URL 向应用发送请求进行授权，并传递店铺名称、店铺 ID、HMAC 和安装来源等基本信息。例如，在 APP URL 字段中填写：[https://stamped-review.apps.shoplazza.com/api/auth](https://stamped-review.apps.shoplazza.com/api/auth)\
**Redirect URL**：应用首页，商家安装应用后将访问该页面。例如，在 Redirect URL 字段中填写：[https://stamped-review.apps.shoplazza.com/api/auth/callback](https://stamped-review.apps.shoplazza.com/api/auth/callback)\
**嵌入选项**：指公有应用部分中"如何将公有应用与 Shoplazza 店铺集成"所描述的内容。\
**事件订阅**：事件可以简单理解为一种"通知"。事件订阅意味着您正在关注某种通知。开发者的事件订阅均通过 [webhook 技术](/docs/app/building-blocks/webhooks/supported-webhook-events)实现。[Webhooks](/docs/app/building-blocks/webhooks/supported-webhook-events) 用于向开发者推送消息，让他们能及时了解某些业务状态并做出相应的业务处理。目前有三个版本：2020-07 和 2020-01。**通常选择 2022-01 版本即可**。\
有关各版本可用的 webhook、每个 webhook 的含义及使用方法，请参阅：附录 - 完整 Webhook 列表。\
**支持的国家/地区**：指明开发者可以看到该应用的地区。

[Webhook](/docs/app/building-blocks/webhooks/supported-webhook-events)

## 管理上架信息

应用上架信息将在应用市场中展示，商家可通过该信息了解应用功能并进行安装。上架信息支持多语言，目前仅支持英文和中文。

1. 在应用设置页面，进入"应用上架信息">"管理上架信息"。

![](https://cnres.appracle.com/4c34b0f3f22e63dfaad66a0a8dcb2f60.png)

2. 点击"开始上架"以添加所需信息。

![](https://cnres.appracle.com/7ac7219f4696a61dafa84d1f1ca28335.png)

3. 在上架信息页面，您可以添加应用基本信息、上架内容、定价详情以及支持与资源。

![](https://cnres.appracle.com/08bce2753b86ab2e8ac2863e503555fd.png)

**应用上架名称**：应用在应用市场中展示的名称，商家可见并使用，支持多语言。相比之下，**应用名称**供开发者管理应用使用，是应用在系统内信息传递的唯一标识符。\
**上架内容**：对您应用的全面介绍，在应用市场中供商家查阅。**详细描述中可嵌入 HTML 代码**以提升视觉效果。可使用"预览"功能查看应用在市场中的展示效果。

![](https://cnres.appracle.com/a4d1115b7f20d0d2adb2ee52287cef03.png)

**定价详情**：选择一种计费模式。

#### 定价配置指南

选择**一种**与您应用付费结构相匹配的定价模式：

  
    
      
        计费类型
      

      
        说明
      
    
  

  
    
      
        **免费**
      

      
        不收取任何费用
      
    

    
      
        **免费安装**
      

      
        免费安装，付费功能/升级  

        * 免费安装 + 可变使用费
      
    

    
      
        **周期性收费**
      

      
        基于订阅的计费（按周/月/年）\
        **仅订阅**  

        * 固定周期费用\
          **订阅 + 使用量**
        * 基础订阅费 + 可变使用费
        * 透明的使用量阶梯（如每 100 封邮件 1 美元）  
      
    

    
      
        **一次性付款**
      

      
        一次付费即可永久使用
      
    
  

##### 1. 免费模式

![](https://cnres.appracle.com/a4d1115b7f20d0d2adb2ee52287cef03.png)

##### 2. 免费安装模式

![](https://cnres.appracle.com/76ce8c5759fae4188b18e7c3b15a11da.png)

##### 3. 周期性收费模式

![](https://cnres.appracle.com/5cf62676bb0f28ba602adbb844457554.png)

* **仅订阅**

  
* **订阅 + 使用量**

  

##### 4. 一次性付款模式

![](https://cnres.appracle.com/c478110761c674638f6de925ecca82f4.png)

![](https://cnres.appracle.com/cdfcdf1cb074b5b9877d2c2755eb4e0e.png)

## 下一步

配置好应用的 Client ID、Client Secret 和 Redirect URL 后，继续阅读[开发独立应用](/docs/app/getting-started/create-public-app/develop-app)来搭建项目并实现 OAuth。
