# 创建私有应用

> 请商家在 Shoplazza 后台创建私有应用，让你的集成拿到调用 Open API 的 Access Token，并说明各字段含义。

# 在店铺后台创建私有应用

Shoplazza 要求私有应用在使用 Shoplazza [Open API](/api/openapi) 之前，必须完成 Access Token [鉴权](/docs/app/building-blocks/authentication/oauth-flow)。

因此，在开始公开开发阶段之前，您需要请商家在 Shoplazza 店铺后台完成以下步骤，为您创建私有应用：

1. **登录 Shoplazza 店铺后台。**

* 全球版：[https://www.shoplazza.com/](https://www.shoplazza.com/)
* 中国版：[https://www.shoplazza.cn/](https://www.shoplazza.cn/)

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

登录您的账号或创建新用户账号。

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

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

登录后，您可以访问店铺后台首页。

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

点击"应用"菜单：

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

2. **点击"管理私有应用"**

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

3. **点击"创建应用"**

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

访问 Shoplazza Admin API 需要权限，不同的 API 需要不同的访问权限。

参阅：[访问权限（Scopes）](/docs/app/building-blocks/authentication/access-scopes)

4. 输入私有应用名称、紧急联系开发者邮箱，选择 [Webhook API](/docs/app/building-blocks/webhooks/supported-webhook-events) 版本和应用权限。

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

* 点击"保存"

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

系统将自动创建 Access token，点击私有应用名称即可查看。

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

私有应用创建完成后，请让商家将私有应用的 AccessToken 提供给您，这样您就可以通过向 Shoplazza Open API 发送鉴权请求开始开发私有应用。

:::note
私有应用必须拥有 Access token 才能向 Shoplazza Open API 发送鉴权请求，详情请参阅 Access Token 相关文档。
:::

## 私有应用字段说明

创建私有应用需要填写以下信息：

| 字段                    | 定义                              | 用途                                                                                                                    |
| ----------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| 私有应用名称            | 私有应用的名称                    | 在 Shoplazza 店铺后台 - 私有应用列表中标识具体的私有应用                                  |
| 紧急联系开发者邮箱      | 应用开发者的邮箱                  | 供商家或 Shoplazza 平台在私有应用出现紧急 bug 时联系私有应用开发者                                                  |
| Webhook API 版本        | 私有应用的 webhook API 版本       | 私有应用使用 webhook 接收由 Shoplazza 平台发起的商家店铺事件回调                                                       |
| 权限                    | 私有应用在 Open API 中可使用的权限 | 出于安全考虑，商家应谨慎控制私有应用的权限。参阅访问权限（Access Scopes）                                              |

# 准备您的应用服务

获得 access\_token 后，您可以访问 Shoplazza OpenAPI，例如：

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

# 测试您的应用

私有应用的测试不需要在 Shoplazza 相关系统中进行任何配置，只需确保应用相应的服务正常稳定运行即可。\
至此，私有应用的创建工作已完成。