API 总览与约定

本页为示例内容，接入真实仓库后自动替换。

基础 URL

所有接口以 https://api.apoints.cn 为根路径，版本前缀 /v1。

鉴权

请求头携带 Authorization: Bearer <access_token>。服务端到服务端调用使用 client_credentials 模式。

统一响应格式

成功：

{ "success": true, "data": {}, "message": "ok", "timestamp": "2026-10-19T13:00:00+08:00" }

失败：

{ "success": false, "error": { "code": "invalid_param", "message": "字段 email 格式不正确" } }

限流

默认每秒 20 次请求。响应头 X-RateLimit-Remaining 返回剩余额度。

分页

列表接口使用 page（从 1 开始）与 page_size（默认 20，最大 100）参数。