什么是 EasyVerein API 技能？

easyVerein API 技能提供了对 easyVerein v2.0 REST 接口的完整技术覆盖，允许开发人员轻松自动化俱乐部管理任务。通过利用此 Openclaw Skills 资源，用户可以与成员、联系人、预订和自定义字段的端点进行交互，确保所有俱乐部数据同步且可访问。该技能还支持 GraphQL 样式的字段选择和批量操作等高级功能，使其成为任何使用 easyVerein 进行数字基础设施建设的组织的强大资产。

下载入口:https://github.com/openclaw/skills/tree/main/skills/truefoobar/easyverein-api

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

EasyVerein API 技能 应用场景

• 通过编程方式创建联系方式和成员记录，实现成员入会流程自动化。
• 将发票和预订等财务数据与第三方会计软件同步。
• 使用批量操作端点管理成员状态或自定义字段的大规模更新。
• 通过细颗粒度的字段选择过滤器获取特定数据子集，从而生成自定义报告。
• 自动监控和刷新 API 令牌，确保长期集成的服务不中断。

1. 通过在请求头中提供 Bearer Token 建立身份验证。
2. AI 代理参考提供的 OpenAPI v2.0 规范来识别正确的端点以及请求/响应模式。
3. 对于成员创建等复杂任务，该技能遵循多步骤工作流，例如在将其链接到成员记录之前先创建联系方式。
4. 使用分页和特定字段查询优化请求，以尽量减少数据开销。
5. 系统监控响应头中的令牌过期情况，并在必要时触发刷新令牌流程。

EasyVerein API 技能 配置指南

要开始使用此 Openclaw Skills 集成，请确保已准备好 API 密钥。将您的令牌设置为环境变量并验证连接：

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

EasyVerein API 技能 数据架构与分类体系

该技能根据 easyVerein v2.0 对象模型组织数据，该模型已在本地 OpenAPI 参考中说明。关键结构包括：

数据检索支持通过 ?query= 参数进行高级过滤，以包含或排除特定字段和嵌套关系。

name: easyverein-api
description: "Work with the easyVerein v2.0 REST API (members, contacts, events, invoices, bookings, custom fields, etc.). Use for full API coverage: endpoint discovery, auth, request/response schemas, and example cURL calls."

easyVerein API (v2.0)

Quick start

• Base URL: https://easyverein.com/api/v2.0
• Auth header: Authorization: Bearer
• 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)

curl -s r
  -H "Authorization: Bearer $EASYVEREIN_TOKEN" r
  -H "Content-Type: application/json" r
  "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.