用途:作为 Salla Admin(商户)API 的基础参考,供其他 Salla 技能在其上构建。它针对商户 access_token 运行,而非 Partners MCP 动作。
主要能力:统一说明 base URL(https://api.salla.dev/admin/v2,仅 HTTPS)、Bearer 令牌认证、请求头、商户身份识别、常用资源端点、分页、错误与限流处理,以及应用设置的读写。
使用方式:所有请求携带 Authorization: Bearer <ACCESS_TOKEN> 与 Accept: application/json,POST/PUT/PATCH 另加 Content-Type: application/json。通过 GET https://accounts.salla.sa/oauth2/user/info 获取并缓存顶层 merchant.id。集合端点支持 page(默认 1)与 per_page(默认 15,最大 60),响应含 pagination(currentPage/totalPages 等)。错误响应为 { status, success, error },校验错误在 error.fields 中按字段给出消息。限流按店铺套餐(Plus 120/分钟、Pro 360/分钟、Special 720/分钟,溢出后 1 请求/秒),Customers 端点另有 500 请求/10 分钟上限;响应头含 X-RateLimit-Limit、X-RateLimit-Remaining、Retry-After、X-RateLimit-Reset。应用设置 GET /apps/{appId}/settings 读取,POST 为整体替换而非合并,需先读再合并后整体写回。
适用场景:需要调用 Salla 商户 API 的集成与自动化任务。
限制:各资源的路径、字段、作用域与响应封装需以对应资源文档或 Partners MCP 为准;令牌存储、刷新与单次刷新令牌规则由 salla-app-auth 负责。资料未提供具体价格与更多平台细节。