Zum Hauptinhalt springen

Schnellstart Cannanas API

Die Cannanas API bietet dir umfassende Möglichkeiten noch mehr aus der Software herauszuholen. Alle Funktionen die in der App verfügbar sind, können auch über die API angesprochen werden.

Preview

Aktuell befindet sich die API in der Preview. Um Zugriff zu erhalten kontaktiere den Support unter support@cannanas.club.

-> Cannanas OpenAPI Specification​

✨ Wichtige Funktionen​

  • Schnelle Integration – Verbinde Daten nahtlos mit Dashboards, Hardware (Waagen, POS, Sensoren) oder Backoffice-Systemen.
  • Rechtskonform bleiben – Alle Endpunkte sind entlang der deutschen CSC-Vorgaben aufgebaut. Exportiere prüffertige Compliance-Reports mit nur einem Aufruf.
  • Zuverlässig & Sicher – Hosting auf deutschen Servern mit 99,9% Verfügbarkeit und kontinuierlichem Monitoring.

🚀 Schnellstart​

1. API-Key erstellen​
  • Öffne dein Profil und gehe zum Bereich API Keys.
  • Erzeuge einen persönlichen API-Key und kopiere ihn.
  • Verwende den Key im Request-Header:
Authorization: Bearer <your-api-key>
Wichtig

API-Key sind immer an deinen Nutzer Account gebunden. Gebe deinen API-Key niemals weiter oder veröffentliche ihn. Er ermöglicht den Zugriff auf deine Vereinsdaten.

2. Direkt im Browser testen​
  • Klicke unten auf Authorize und füge deinen API-Key ein.
  • Teste die Authentifizierung mit dem Authentication Test Endpoint.
  • Klicke Try it out → Execute.
  • Eine erfolgreiche Antwort sieht so aus:
{ "message": "Authentication successful" }
3. Mit curl testen​
curl https://api.cannanas.club/v1/auth/test --header 'Authorization: Bearer <your-api-key>'

💬 Support​