快速开始

本页为示例内容。仓库 ApointsDev/docs 接入后，本目录内容由该仓库同步替换。

1. 创建应用

登录 auth.apoints.cn 控制台，创建应用并获取 client_id 与 client_secret。

2. 获取访问令牌

curl -X POST https://api.apoints.cn/oauth2/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "<CLIENT_ID>",
    "client_secret": "<CLIENT_SECRET>",
    "scope": "docs:read"
  }'

响应遵循统一格式：

{
  "success": true,
  "data": {
    "access_token": "eyJhbGciOi...",
    "expires_in": 7200
  },
  "message": "ok",
  "timestamp": "2026-10-19T13:00:00+08:00"
}

3. 调用第一个接口

curl https://api.apoints.cn/v1/users/me \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

常见问题

错误码	含义	处理方式
401 invalid_token	令牌过期或无效	重新获取访问令牌
403 insufficient_scope	scope 不足	在控制台为应用追加 scope
429 rate_limited	触发限流	降低频率或申请提额

下一步阅读 配置说明 了解全部可配置项。