API & Integrationen

Auf Collabaro aufbauen. Mit allem integrieren.

Die Collabaro Third Party API (TAPI) bietet Ihnen programmatischen Zugriff auf Ihre Betriebsdaten über HTTPS. Verbinden Sie Ihr ERP, CRM, BI-Tools oder jedes andere Drittanbieter-System — und nutzen Sie Webhooks, um in Echtzeit auf Ereignisse zu reagieren.

14
Ressourcendomänen
REST
HTTPS + JSON
CRUD
Vollständiger Lebenszyklus
Webhooks
Ereignisgesteuert
Authentifizierung

Einfacher, sicherer API-Zugang

Authentifizieren Sie sich mit einem API-Schlüssel, den Sie in der Collabaro-Web-App generieren. Übergeben Sie ihn im X-Auth-Token-Header bei jeder Anfrage.

// Mit Ihrem API-Schlüssel authentifizieren
curl https://your-instance.collabaro.com/tapi/v1/timesheet
  -H "X-Auth-Token: YOUR_API_KEY"
// Erfolg: 200 mit JSON-Antwort
{"result": "ok", "data": [...]}
// Fehler: 401 mit JSON-Fehlerobjekt
{"result": "error", "message": "Authentication failed"}
Ressourcendomänen

Alles, was Ihre Integration benötigt

Die TAPI stellt 14 Ressourcendomänen mit vollständigen CRUD-Operationen bereit. Listen Sie Datensätze auf, rufen Sie sie ab, fügen Sie sie ein, aktualisieren und löschen Sie sie — über Ihren gesamten Collabaro-Datenbestand.

Projekte

Erstellen, aktualisieren, auflisten und verwalten Sie Windenergieprojekte. Abfragen nach Umfang, Projektdetails abrufen und den Projektlebenszyklus von der Anlage bis zum Abschluss verfolgen.

Jobs

Vollständige Job-Verwaltung einschließlich Einfügen, Aktualisieren, Löschen und Auflisten. Aufgabentypen zuweisen, Anhänge hoch- und herunterladen sowie Jobs nach Datumsbereich abfragen.

Aufgaben

Aufgaben verwalten, Aufgabendatensätze abrufen, Teilnehmer festlegen, Bilder herunter- und hochladen. Umfasst Statusverfolgung, Datenwert-Operationen und Teilnehmerabfragen nach Datum.

Stundenzettel

GPS-verifizierte Stundenzetteldaten mit konfigurierbaren Parametern extrahieren. Nach Datumsbereich, Projekt oder Techniker filtern. Enthält detaillierte Antwortfelder für Abrechnungs- und Gehaltsintegrationen.

Berichte

Berichtstypen auflisten, Berichte programmatisch erstellen, Generierungsstatus prüfen und fertige Berichte herunterladen. Automatisieren Sie Ihren gesamten Berichts-Workflow über die API.

Benutzer & Rollen

Techniker- und Benutzerdatensätze verwalten, aktive Technikerlisten abfragen, Benutzerfotos verarbeiten und Anmeldehistorien abrufen. Rollen zuweisen und Zugriffstoken programmatisch verwalten.

Standorte

Windparkstandorte mit vollständigen CRUD-Operationen erstellen und verwalten. Standortdetails einschließlich Zeitzonenkonfiguration für präzise Planung über verschiedene Regionen hinweg abrufen.

Assets & Konfiguration

Asset-Typen und einzelne Assets (Turbinen, Rotorblätter, Komponenten) verwalten. Dazu Baumstrukturen, Aufgabentypen, Aufgabenkategorien und Jobtypen auflisten — für vollständige Konfigurationskontrolle.

Webhooks

Abonnieren Sie Ereignisse und empfangen Sie HTTP-Callbacks in Echtzeit, wenn sich Daten in Collabaro ändern. Erstellen Sie ereignisgesteuerte Integrationen, die sofort auf Feldaktivitäten reagieren.

Codebeispiele

Sehen Sie es in Aktion

Echte Endpoints aus der Collabaro TAPI. Alle Antworten werden als JSON zurückgegeben.

Projekte

// Alle Projekte auflisten
GET /tapi/v1/project/list
// Projektdetails abrufen
GET /tapi/v1/project/get?id={id}
// Neues Projekt erstellen
POST /tapi/v1/project/insert

Aufgaben & Daten

// Aufgabenübersicht abrufen
GET /tapi/v1/task/getsummary
// Aufgabendatensatz abrufen
GET /tapi/v1/task/getdatarecord
// Aufgabenbild hochladen
POST /tapi/v1/task/uploadimage

Stundenzettel & Berichte

// Zeiterfassungsdaten extrahieren
GET /tapi/v1/timesheet
// Bericht erstellen
POST /tapi/v1/report/create
// Erstellten Bericht herunterladen
GET /tapi/v1/report/download
Branchenintegrationen

Vernetzt mit dem Windenergie-Ökosystem

Collabaro integriert sich mit den Plattformen, die Ihre Kunden und Partner bereits nutzen.

WINDA (GWO)

Überprüfen Sie GWO-Schulungsnachweise und Sicherheitszertifizierungen (BST, BTT, ART) von Technikern direkt in Collabaro, bevor Sie Personal für Projekte einplanen. So wird sichergestellt, dass nur qualifizierte Techniker zum Einsatzort entsandt werden.

Nordex SNOW

Übermitteln Sie Rotorblatt-Inspektionsdaten direkt in die proprietäre Service-Management-Plattform von Nordex. Dies eliminiert manuelle Neueingaben und stellt sicher, dass der OEM präzise, zeitnahe Inspektionsberichte aus dem Dienstleisterbetrieb erhält.

Salesforce

Eine bewährte, über die TAPI aufgebaute Integration verbindet Collabaro-Feldoperationsdaten mit Salesforce CRM. Übertragen Sie Projektabschluss-, Stundenzettel-, Job- und Aktivitätsdaten für eine einheitliche Sicht auf die operative Leistung.

Bereit für die Integration?

Die TAPI-Dokumentation steht Kunden und Evaluierungspartnern zur Verfügung. Sprechen Sie mit uns über Ihre Integrationsanforderungen und wir richten alles für Sie ein.