# Shoplazza REST API 概览

> Shoplazza REST API 概览：Admin API 能读写哪些商家数据、使用前提要求，以及各主题文档的入口。

Shoplazza 提供了一套 [API](/zh-CN/api/openapi)，供开发者扩展平台功能。其中的 [Admin API](/zh-CN/api/openapi) 通过 REST 方式访问，可读取和写入商家店铺、商品、订单等数据，与其他系统和平台进行互操作，并为 Shoplazza 后台（商家使用的店铺管理界面）添加功能。开始调用请参阅 [API 使用说明](/zh-CN/docs/app/building-blocks/rest-api/api-usage)。

## 使用 Shoplazza API 的要求

*   所有 API 的使用均受 Shoplazza API 许可协议和服务条款约束。
*   每个请求都需要[鉴权](/zh-CN/docs/app/building-blocks/authentication/oauth-flow)。
*   应用在安装期间须明确向商家申请所需的[访问权限](/zh-CN/docs/app/building-blocks/authentication/access-scopes)。
*   这是[版本化](/zh-CN/docs/app/building-blocks/rest-api/versioning) API，每半年发布一次更新。
*   Admin API 对所有请求强制执行[速率限制](/zh-CN/docs/app/building-blocks/rest-api/rate-limits)。

## 接口数量

下表是 Admin API 各版本的公开接口数，和 [API 参考](/zh-CN/api/openapi)里列出的接口一致。

| 版本 | 公开接口数 |
| --- | --- |
| 202701 | 360 |
| 202607（默认版本） | 360 |
| 202601 | 360 |
| 202506 | 271 |
| 202201 | 219 |

## 主题导航

- [使用 API](/zh-CN/docs/app/building-blocks/rest-api/api-usage): 调用约定、请求格式、认证 Header
- [OAuth 鉴权](/zh-CN/docs/app/building-blocks/authentication/oauth-flow): 公开应用的安装与授权流程、Access Token / Refresh Token
- [访问权限（Scopes）](/zh-CN/docs/app/building-blocks/authentication/access-scopes): 申请、变更与重新授权
- [HMAC 签名校验](/zh-CN/docs/app/building-blocks/authentication/signature-verification): OAuth 回调 / Webhook 等场景的签名算法
- [速率限制](/zh-CN/docs/app/building-blocks/rest-api/rate-limits): 调用频率约束与最佳实践
- [分页](/zh-CN/docs/app/building-blocks/rest-api/pagination): 列表接口翻页约定
- [HTTP 状态码](/zh-CN/docs/app/building-blocks/rest-api/http-status): 错误码与排错指引
- [公共参数](/zh-CN/docs/app/building-blocks/rest-api/public-parameters): 通用查询/排序参数