# Webshop Admin API 参考

> 了解可用于以编程方式配置商店、环境、主题和品牌的 Webshop Admin API 终端。

建议的最佳做法是管理员在 [Unity Dashboard（Unity 后台](https://cloud.unity.com)）中配置网上商店。

当 Unity Dashboard（Unity 后台）不适合您的工作流程时，例如您需要执行以下操作时，请使用 Webshop Admin API：

* 在许多环境中更新主题。
* 作为项目设置的一部分，编写创建网上商店的脚本。
* 将网上商店配置集成到部署管线中。

本页面链接至 API 参考，并介绍身份验证和授权如何用于管理 API 调用。

## 身份验证##authentication

Admin API 使用[服务帐户](https://services.docs.unity.com/docs/service-account-auth/)凭据。从 Unity Dashboard（Unity 后台）生成服务帐户密钥，对`key_id:secret_key`对进行 base64 编码，并在请求中将其作为不记名令牌发送。

有关分步说明，请参阅[服务帐户身份验证指南](https://services.docs.unity.com/docs/service-account-auth/)。

## Authorization（授权）##authorization

每个 Admin API 终端都需要一个特定的服务帐户角色。有关角色列表和每个操作的要求，请参阅 [Webshop 权限参考](./permissions.md)。

## API 参考##api-reference

[Webshop Admin API reference](/oas-webshop-admin/latest.md): 每个管理终端的 OpenAPI 引用。