获取访问凭证

业务接口调用前，先通过 OAuth2 client credentials 流程换取访问令牌。令牌应缓存到过期前，不要为每个请求重复申请。

请求

POST /oauth2/v2.0/token HTTP/1.1
Host: alimail-cn.aliyuncs.com
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials&client_id=<client_id>&client_secret=<client_secret>

Python 示例

import os
import time
import requests

TOKEN_URL = "https://alimail-cn.aliyuncs.com/oauth2/v2.0/token"


def get_access_token() -> tuple[str, float]:
    response = requests.post(
        TOKEN_URL,
        data={
            "grant_type": "client_credentials",
            "client_id": os.environ["ALIMAIL_CLIENT_ID"],
            "client_secret": os.environ["ALIMAIL_CLIENT_SECRET"],
        },
        timeout=10,
    )
    response.raise_for_status()
    payload = response.json()
    expires_at = time.time() + int(payload["expires_in"])
    return payload["access_token"], expires_at

使用建议

• 将 client_id 和 client_secret 放在密钥管理服务或运行时 Secret 中。
• 在 expires_at 前预留刷新窗口，例如提前 5 分钟获取新令牌。
• 多实例服务使用共享缓存和互斥刷新，避免令牌过期时并发申请。
• 不要打印完整响应，响应中包含访问令牌。

参考：原始示例、API 开放平台概览。