easyverein-api
Pełny dostęp do API easyVerein — zarządzaj członkami, kontaktami, wydarzeniami i fakturami
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill do pracy z REST API easyVerein v2.0. Odkrywaj wszystkie endpointy, konfiguruj autoryzację, sprawdzaj schematy żądań i odpowiedzi, oraz generuj przykładowe polecenia cURL. Obsługuje operacje na członkach, kontaktach, wydarzeniach, fakturach, rezerwacjach i polach niestandardowych. Zawiera pełną specyfikację OpenAPI, dokumentację wzorców paginacji, selekcji pól oraz operacji zbiorczych.
Jak używać
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ść.