easyverein-api
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.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
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.
How to use
Przygotuj token API — uzyskaj klucz dostępu do easyVerein i przechowuj go w zmiennej środowiskowej EASYVEREIN_TOKEN. Pamiętaj, że tokeny wygasają po 30 dniach.
Zapoznaj się ze specyfikacją OpenAPI — otwórz plik references/openapi-v2.json, aby zobaczyć wszystkie dostępne endpointy pogrupowane po tagach (member, contact-details, invoice itp.), parametry, schematy ciał żądań i formaty odpowiedzi.
Zanim utworzysz członka, utwórz najpierw contact-details — API wymaga, aby najpierw istniały dane kontaktowe, a następnie możesz je powiązać z nowym członkiem poprzez referencję emailOrUserName i contactDetails.
Konstruuj żądania z uwzględnieniem limitów — używaj parametru limit (domyślnie 5, maksymalnie 100) do paginacji wyników, parametru query do selekcji konkretnych pól (np. {field,relation{subfield}}) oraz prefiksu minus do wykluczenia pól ({-field}).
Wysyłaj żądania do https://easyverein.com/api/v2.0 z nagłówkiem Authorization: Bearer TWÓJ_TOKEN i Content-Type: application/json. Pamiętaj o limicie 100 żądań na minutę.
Odświeżaj token, gdy zobaczysz w nagłówkach odpowiedzi flagę tokenRefreshNeeded — wyślij GET /api/v2.0/refresh-token, a stary token natychmiast utraci ważność.