鉴权
使用 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,在控制台「集成 → 密钥管理」创建 | Y |
client_secret | 客户端密钥,与 client_id 一起创建 | Y |
scope | 固定值 company:TENANT:admin | Y |
请求示例(测试环境):
curl -X POST "https://api.test.stabofx.com/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 即可。