Übersicht öffentliche API
Organisationsbezogene REST-API für Veranstaltungen, Tickets, Bestellungen, Rabatte und Webhooks
Die öffentliche Cowtic-API ist eine versionierte REST-API unter /api/v1. Jeder Schlüssel gehört zu genau einer Organisation. Nutzen Sie sie für Automatisierung von Veranstaltungen, Checkout, Ticketausgabe, Check-in und Webhooks.
Basis-URL
https://api.cowtic.com/api/v1In der lokalen Entwicklung läuft der Server üblicherweise unter Ihrer konfigurierten NEXT_PUBLIC_SERVER_URL (zum Beispiel http://localhost:8080/api/v1). Die Web-App leitet /api/* an diesen Server weiter, sodass /api/v1/openapi.json auch über den Docs-Host erreichbar ist.
OpenAPI-Spezifikation
Die maschinenlesbare OpenAPI-3.1-Spezifikation finden Sie hier:
- Laufzeit:
/api/v1/openapi.json - Interaktive Referenz: API erkunden und Anfragen senden
API-Schlüssel erstellen
- Öffnen Sie das Veranstalter-Dashboard.
- Gehen Sie zu Organisationseinstellungen → API-Schlüssel.
- Erstellen Sie einen Schlüssel mit den benötigten Berechtigungen (Scopes).
- Kopieren Sie den geheimen Schlüssel einmalig — er wird nur bei Erstellung oder Rotation angezeigt.
Leitfäden
JavaScript- und TypeScript-SDK
Den offiziellen typisierten Client installieren
API-Referenz
Schemas erkunden und Anfragen direkt im Browser senden
Authentifizierung
X-Api-Key und Bearer-Auth
Scopes
Ressourcen- und Aktionsberechtigungen
Paginierung
Cursor-basierte Listenendpunkte
Idempotenz
Sichere Retries bei Create und Issue
Fehler
RFC-9457-problem+json-Antworten
Rate Limits
RateLimit-Header und 429-Behandlung
Checkout
Kostenlose Auto-Ausgabe vs. Zahls-Checkout
Headless-Checkout
Eigener Warenkorb, Zahls-Redirect und Ticketausstellung
Webhooks
HMAC-Signaturen und Retries
Versionierung
Kompatibilitäts- und Deprecation-Richtlinie
Ressourcenübersicht
| Bereich | Endpunkte |
|---|---|
| Veranstaltungen | /events, /events/{eventId} |
| Tickettypen | /events/{eventId}/ticket-types, /ticket-types/{ticketTypeId} |
| Bestellungen | /orders, /orders/{orderId}, /orders/{orderId}/cancel |
| Tickets | /tickets, /tickets/issue, /tickets/check-in, /tickets/{ticketId} |
| Rabatte | /discounts, /discounts/validate, /discounts/{discountId} |
| Webhooks | /webhooks, /webhooks/{webhookId}, Deliveries, Secret rotieren |