API e integrazioni

Sviluppi su Collabaro. Integri qualsiasi sistema.

La Collabaro Third Party API (TAPI) offre accesso programmatico ai dati operativi tramite HTTPS. È possibile collegare ERP, CRM, strumenti di BI o qualsiasi sistema di terze parti, e usare i webhook per reagire agli eventi in tempo reale.

14
Domini di risorse
REST
HTTPS + JSON
CRUD
Operazioni sull'intero ciclo di vita
Webhooks
Basato su eventi
Autenticazione

Accesso API semplice e sicuro

Per autenticarsi si usa una chiave API generata dall'app web di Collabaro, da passare nell'intestazione X-Auth-Token a ogni richiesta.

// Autenticarsi con la propria chiave API
curl https://your-instance.collabaro.com/tapi/v1/timesheet
  -H "X-Auth-Token: YOUR_API_KEY"
// Operazione riuscita: 200 con risposta JSON
{"result": "ok", "data": [...]}
// Errore: 401 con oggetto di errore JSON
{"result": "error", "message": "Authentication failed"}
Domini di risorse

Tutto ciò di cui ha bisogno la sua integrazione

La TAPI espone 14 domini di risorse con operazioni CRUD complete. È possibile elencare, recuperare, inserire, aggiornare ed eliminare i record nell'intero dataset Collabaro.

Progetti

Creare, aggiornare, elencare e gestire i progetti di energia eolica. Interrogare per ambito, recuperare i dettagli dei progetti e tracciare il ciclo di vita dall'inserimento fino al completamento.

Interventi

Gestione completa degli interventi, con operazioni di inserimento, aggiornamento, eliminazione ed elenco. Associare tipi di attività, caricare e scaricare allegati e interrogare gli interventi per intervallo di date.

Attività

Gestire le attività, recuperare i record dei dati delle attività, impostare i partecipanti, scaricare e caricare immagini. Include il tracciamento dello stato, le operazioni sui valori dei dati e le query sui partecipanti per data.

Timesheet

Estrarre dati dei timesheet verificati tramite GPS con parametri configurabili. Filtrare per intervallo di date, progetto o tecnico. Include campi di risposta dettagliati per l'integrazione con fatturazione e paghe.

Report

Elencare i tipi di report, creare report in modo programmatico, verificare lo stato di generazione e scaricare i report completati. Automatizzare l'intero flusso di reportistica tramite l'API.

Utenti e ruoli

Gestire i record di tecnici e utenti, interrogare gli elenchi dei tecnici attivi, gestire le foto degli utenti e recuperare la cronologia degli accessi. Assegnare ruoli e gestire i token di accesso in modo programmatico.

Siti

Creare e gestire i siti dei parchi eolici con operazioni CRUD complete. Recuperare i dettagli del sito, compresa la configurazione del fuso orario, per una pianificazione accurata nelle diverse aree geografiche.

Asset e configurazione

Gestire i tipi di asset e i singoli asset (turbine, pale, componenti). In più, elencare alberi, tipi di attività, categorie di attività e tipi di intervento per un controllo completo della configurazione.

Webhooks

Iscriversi agli eventi e ricevere callback HTTP in tempo reale quando i dati cambiano in Collabaro. Creare integrazioni basate sugli eventi che reagiscono subito all'attività sul campo.

Esempi di codice

Lo veda in azione

Endpoint reali della TAPI di Collabaro. Tutte le risposte restituiscono JSON.

Progetti

// Elenca tutti i progetti
GET /tapi/v1/project/list
// Recupera i dettagli del progetto
GET /tapi/v1/project/get?id={id}
// Crea un nuovo progetto
POST /tapi/v1/project/insert

Attività e dati

// Recupera il riepilogo dell'attività
GET /tapi/v1/task/getsummary
// Recupera il record dei dati dell'attività
GET /tapi/v1/task/getdatarecord
// Carica l'immagine dell'attività
POST /tapi/v1/task/uploadimage

Timesheet e report

// Estrai i dati del timesheet
GET /tapi/v1/timesheet
// Crea un report
POST /tapi/v1/report/create
// Scarica il report generato
GET /tapi/v1/report/download
Integrazioni di settore

Connesso all'ecosistema dell'energia eolica

Collabaro si integra con le piattaforme che i suoi clienti e partner già utilizzano.

WINDA (GWO)

Verificare direttamente in Collabaro i registri di formazione GWO e le certificazioni di sicurezza dei tecnici (BST, BTT, ART) prima di assegnare il personale ai progetti. Garantisce che in sito siano impiegati solo tecnici qualificati.

Nordex SNOW

Inviare i dati di ispezione delle pale direttamente alla piattaforma proprietaria di gestione dei servizi di Nordex. Elimina il reinserimento manuale e garantisce che l'OEM riceva registri di ispezione accurati e tempestivi dalle attività degli appaltatori.

Salesforce

Un'integrazione collaudata, sviluppata tramite la TAPI, collega i dati operativi sul campo di Collabaro a Salesforce CRM. È possibile inviare i dati su completamento dei progetti, timesheet, interventi e attività per una visione unificata delle prestazioni operative.

Pronti a integrare?

La documentazione della TAPI è disponibile per i clienti e per i partner in fase di valutazione. Ci parli delle sue esigenze di integrazione e la aiuteremo a configurare tutto.