easyverein-api

TotalClaw 作者 totalclaw

使用 easyVerein v2.0 REST API（成员、联系人、事件、发票、预订、自定义字段等）。用于完整的 API 覆盖：端点发现、身份验证、请求/响应模式和示例 cURL 调用。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~truefoobar-easyverein-api

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~truefoobar-easyverein-api/file -o truefoobar-easyverein-api.md

## 概述（中文）

使用 easyVerein v2.0 REST API（成员、联系人、事件、发票、预订、自定义字段等）。用于完整的 API 覆盖：端点发现、身份验证、请求/响应模式和示例 cURL 调用。

## 原文

# easyVerein API (v2.0)

## Quick start
- Base URL: `https://easyverein.com/api/v2.0`
- Auth header: `Authorization: Bearer <API_KEY>`
- Tokens expire after 30 days; refresh via `GET /api/v2.0/refresh-token` when `tokenRefreshNeeded` appears in response headers.
- Rate limit: **100 requests/min**.

## Use the OpenAPI spec
Read the full spec when you need endpoint details or schemas:
- `references/openapi-v2.json`

This file contains **all endpoints**, parameters, request bodies, responses, and tags. Use it to:
- list endpoints by tag (e.g., `member`, `contact-details`, `invoice`)
- inspect request body schemas
- find actions and sub-endpoints

## Common patterns
- Pagination: `?limit=` (default 5, max 100)
- Field selection: `?query={field,relation{subfield}}`
- Excluding fields: `?query={-field}`
- Bulk operations: `bulk-create` / `bulk-update` (supported by select endpoints)

## Example cURL (template)
```bash
curl -s \
  -H "Authorization: Bearer $EASYVEREIN_TOKEN" \
  -H "Content-Type: application/json" \
  "https://easyverein.com/api/v2.0/member?limit=10"
```

## Member creation flow (important)
1) Create `contact-details` first.
2) Then create `member` with `emailOrUserName` and `contactDetails` reference.

## Notes
- Files must be uploaded via **PATCH** with `Content-Disposition` header.
- Use `refresh-token` to rotate tokens; old token becomes invalid immediately.