名称： easyverein-api
描述： "使用 easyVerein v2.0 REST API（成员、联系人、活动、发票、记账、自定义字段等）。用于完整的 API 覆盖：端点发现、认证、请求/响应模式以及 cURL 调用示例。"

easyVerein API (v2.0)

快速开始

• 基础 URL: https://easyverein.com/api/v2.0
• 认证请求头: Authorization: Bearer <API_KEY>
• 令牌有效期为 30 天；当响应头中出现 tokenRefreshNeeded 时，请通过 GET /api/v2.0/refresh-token 刷新令牌。
• 速率限制: 每分钟 100 次请求。

使用 OpenAPI 规范

当您需要端点详情或模式时，请阅读完整的规范文件：
- references/openapi-v2.json

此文件包含所有端点、参数、请求体、响应和标签。您可以使用它来：
- 按标签（例如 member、contact-details、invoice）列出端点
- 检查请求体模式
- 查找操作和子端点

常用模式

• 分页: ?limit= (默认 5，最大 100)
• 字段选择: ?query={field,relation{subfield}}
• 排除字段: ?query={-field}
• 批量操作: bulk-create / bulk-update (部分端点支持)

cURL 示例（模板）

curl -s \
  -H "Authorization: Bearer $EASYVEREIN_TOKEN" \
  -H "Content-Type: application/json" \
  "https://easyverein.com/api/v2.0/member?limit=10"

成员创建流程（重要）

1) 首先创建 contact-details。
2) 然后使用 emailOrUserName 和 contactDetails 引用创建 member。

注意事项

• 文件必须通过 PATCH 方法并附带 Content-Disposition 请求头进行上传。
• 使用 refresh-token 端点轮换令牌；旧令牌将立即失效。