Riferimento API
L'API REST di Flowtly — 927 endpoint su 192 risorse, generati dallo schema OpenAPI attuale.
Questo riferimento è generato dallo schema API. Le descrizioni dei campi e qualsiasi testo non ancora tradotto sono mostrati in inglese.
Prima di iniziare a sviluppare
Autenticazione
Invia un token di accesso personale nell'intestazione Authorization: Bearer <token>. Crealo in Flowtly, nella pagina Sicurezza del tuo profilo. Un token agisce con i tuoi permessi, dura 365 giorni salvo diversa scelta (al massimo 730) e può essere revocato lì in qualsiasi momento.
Intestazione dell'organizzazione
Ogni richiesta porta anche un'intestazione instance con l'ID dell'organizzazione in cui operi. Senza di essa, l'API rifiuta la richiesta.
Richieste e risposte
Le risposte sono in JSON-LD (application/ld+json) o in JSON semplice (application/json). Gli aggiornamenti usano PATCH con application/merge-patch+json. Le collezioni sono paginate con page e itemsPerPage, al massimo 500 elementi per pagina.
Versionamento
L'API non ha versioni nei percorsi né nelle intestazioni: le risorse stanno alla radice, per esempio https://api.flowtly.eu/projects. Il documento OpenAPI 3.1 è pubblicato su https://api.flowtly.eu/docs.json.
Limiti di frequenza
Le richieste sono soggette a un limite di frequenza. Le richieste di scrittura (POST, PUT, PATCH, DELETE) vengono conteggiate per organizzazione in una finestra di cinque minuti, con un limite più alto una volta che l'organizzazione è verificata o abbonata. Superato un limite, l'API risponde 429 Too Many Requests con un'intestazione Retry-After che indica i secondi da attendere. I limiti possono cambiare, quindi leggi Retry-After invece di fissare un numero nel codice.
Deprecazioni
Un endpoint o un campo in via di ritiro è contrassegnato come deprecated nel documento OpenAPI. L'API non invia intestazioni di deprecazione, quindi controlla il documento quando aggiorni un'integrazione.
Testare la tua integrazione
Non esiste un sandbox separato. Testa la tua integrazione in uno spazio di lavoro di prova con dati di esempio prima di collegare i dati reali. Finché l'organizzazione non è verificata né abbonata, una prova funziona con un limite di scrittura più basso e non invia e-mail.
Cosa è cambiato
Le modifiche all'API vengono annunciate nelle note di rilascio, insieme al resto del prodotto.
Leggi le note di rilascioProgetti e consegne
97Progetti, attività, membri, tariffe e allocazioni — automatizza la delivery e sincronizza i dati di progetto.
Resourcing e capacità
11Allocazioni, il bench, la finestra di pianificazione e i consuntivi — pianifica chi lavora su cosa, e rileggi cosa hanno fatto.
Fatturazione e pagamenti
49Fatture, righe, pagamenti, promemoria e fatturazione elettronica (KSeF) — automatizza la fatturazione end-to-end.
Budget e spese
159Budget, transazioni, costi, imposte e conti bancari — monitora la spesa e riconcilia automaticamente.
CRM — lead e trattative
78Lead, trattative, pipeline e fasi — gestisci il funnel di vendita dai tuoi sistemi.
Clienti e controparte
34Clienti, contatti e controparte — mantieni la sincronizzazione tra il tuo CRM e Flowtly.
HR e persone
87Dipendenti, dipartimenti, posizioni, benefit e responsabilità — automatizza i flussi di dati HR.
Performance e valutazioni
31Cicli di valutazione, modelli, domande e sessioni — gestisci le valutazioni delle performance in modo programmatico.
Tempo e presenze
67Orario di lavoro, ferie, turni e festività — registra e leggi le presenze programmaticamente.
Recruitment & ATS
40Candidati, attività di selezione, colloqui e pianificazione — collega il tuo ATS.
Proprietà e asset
50Immobili, prenotazioni, asset, contatori e letture — gestisci i dati immobiliari tramite l'API.
Contratti e compliance
48Accordi, contratti, allegati e piani di pagamento — automatizza i flussi contrattuali.
Documenti e firme
20Documenti, archiviazione e richieste di firma elettronica — carica, organizza e firma i file.
Personalizzazione e tag
62Attributi, set di attributi, regole e tag — estendi gli oggetti Flowtly con i tuoi campi personalizzati.
Organizzazione e configurazione
48Organizzazione, sedi, utenti, integrazioni e abbonamento — configura lo spazio di lavoro.
Utenti e accessi
16Utenti e gruppi di permessi — gestisci chi può vedere e fare cosa.
Webhook e audit
14Webhook e log di audit — reagisci agli eventi e traccia i cambiamenti.
Esportazioni contabili
16Esportazioni verso Wapro, Optima, Enova, Symfonia, MT940 e SEPA — consegna i dati al tuo commercialista.
Server MCP
Connetti strumenti AI a Flowtly tramite il Model Context Protocol su mcp.flowtly.eu.