GraphQL-Schnittstelle in Starhunter

Geändert am Mi, 18 Feb um 6:05 NACHMITTAGS

Überblick

Die GraphQL-Schnittstelle ermöglicht es Ihnen, Daten aus Ihrem Starhunter-System abzufragen und in andere Anwendungen zu integrieren.

Endpoint

/Api/graphql

Beispiel: https://ihre-firma.starhunter.software/Api/graphql

Authentifizierung

Die GraphQL-API erfordert einen API-Token für die Autorisierung. Dieser wird als Authorization-Header bei jedem Request mitgegeben:

Authorization: Bearer [IHR_API_TOKEN]

API-Token erstellen

Melden Sie sich in Ihr Starhunter-System an
Klicken Sie auf Ihr Profilbild oben rechts
Wählen Sie Einstellungen → Login → API Tokens
Klicken Sie auf das Plus-Symbol (+) für einen neuen Token
Geben Sie dem Token einen aussagekräftigen Namen (z.B. "GraphQL Integration") und ein Ablaufdatum ein
Klicken Sie auf Hinzufügen
Kopieren Sie das generierte Token sofort und bewahren Sie es sicher auf

⚠️ Wichtig: Das Token wird nur einmal angezeigt und kann danach nicht mehr eingesehen werden. Falls es verloren geht, muss ein neues Token erstellt werden.

Tipp: Löschen Sie Tokens regelmäßig, wenn diese nicht mehr benötigt werden.

Dokumentation

Eine detaillierte Dokumentation der verfügbaren GraphQL-Queries und Typen finden Sie direkt in Ihrem Starhunter-System unter:

/Api/docs

Diese interaktive Dokumentation listet alle verfügbaren Abfragen und Felder auf.

Weiterführende Ressourcen

Wenn Sie die GraphQL-Schnittstelle in automatisierten Workflows einsetzen möchten, empfehlen wir unsere Einrichtungsanleitung für den Starhunter n8n Node.