easyVerein API接入

技能简介

该技能用于对接 easyVerein v2.0 REST API，支持会员、联系人、活动、发票、记账、自定义字段等全功能调用。提供端点发现、认证流程、请求/响应结构说明及 cURL 示例。

业务背景

德国协会及会员制组织可无缝打通 easyVerein 管理系统与自有业务平台，实现会员数据、财务流水、活动报名的自动化流转。财务部门能实时同步发票状态，运营团队可批量处理活动报名，避免手工导出Excel带来的延迟和差错，提升组织数字化运营效率。

落地案例：某华人商会使用此技能将会员系统与官网打通：新会员在线提交申请后，自动写入 easyVerein 并生成 contact-details 档案；每月初自动拉取未缴费会员清单触发催缴通知；年度大会报名时，参会数据实时回写至 easyVerein 活动模块，管理员无需切换后台即可掌握完整参与情况。

能做什么

• 查询和管理协会会员信息
• 处理联系人详情与关联数据
• 创建和追踪发票、记账记录
• 管理活动报名与日程
• 操作自定义字段实现灵活扩展
• 执行批量创建/更新操作

使用说明

1. 获取 API 密钥：登录 easyVerein 后台，在设置中生成访问令牌
2. 配置环境变量：export EASYVEREIN_TOKEN="your_api_key"
3. 安装依赖：无需额外安装，直接使用 HTTP 客户端或参考 references/openapi-v2.json 生成 SDK
4. 发起请求：基础 URL 为 https://easyverein.com/api/v2.0，Header 需包含 Authorization: Bearer $EASYVEREIN_TOKEN
5. 处理分页：使用 ?limit= 参数，默认 5 条，最大 100 条
6. 刷新令牌：当响应头出现 tokenRefreshNeeded 时，调用 GET /api/v2.0/refresh-token；旧令牌立即失效

输入与输出

见下方输入与输出表格。

风险提示

• 令牌 30 天过期，需主动刷新避免服务中断
• 速率限制 100 请求/分钟，超限将触发限制
• 文件上传需使用 PATCH 方法并附加 Content-Disposition 头
• 创建会员前必须先创建 contact-details 并建立引用关系

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/truefoobar/easyverein-api/SKILL.md
来源类型：GitHub 仓库