鉴权

使用 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_credentialsY
client_id客户端 ID,在控制台「集成 → 密钥管理」创建Y
client_secret客户端密钥,与 client_id 一起创建Y
scope固定值 company:TENANT:adminY

请求示例(测试环境):

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 即可。

本页目录