鉴权
使用 OAuth2 Client Credentials 模式获取 Access Token。
API 使用 OAuth2 Client Credentials 模式进行鉴权。Token 有效期为 2 小时，建议商户侧缓存复用，并在过期前刷新。
获取 Access Token
请求地址: POST /oauth2/token
请求头:
Content-Type: application/x-www-form-urlencoded
X-Tenant-ID: {tenant_id}
X-Tenant-Type: COMPANY缺少 X-Tenant-ID 或 X-Tenant-Type 时，返回 invalid_client。
请求参数（application/x-www-form-urlencoded）:
| 参数 | 说明 | 必填 |
|---|---|---|
grant_type | 固定值 client_credentials | Y |
client_id | 客户端 ID（由 Stabo 提供） | Y |
client_secret | 客户端密钥（由 Stabo 提供） | Y |
scope | 固定值 company:TENANT:admin | Y |
请求示例:
curl -X POST "https://api.stabo.io/oauth2/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "X-Tenant-ID: your_tenant_id" \
-H "X-Tenant-Type: COMPANY" \
-d "grant_type=client_credentials&client_id=your_client_id&client_secret=your_client_secret&scope=company:TENANT:admin"响应示例:
{
"access_token": "eyJhbGciOiJSUzI1NiIs...",
"token_type": "Bearer",
"expires_in": 7200
}expires_in 的单位为秒。
使用 Token
业务接口通过 Authorization: Bearer {accessToken} 请求头鉴权。
最佳实践: 请将 Token 缓存在应用中复用，避免每次请求都获取新 Token。收到 401 错误时，重新获取 Token 即可。