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 rilascio

Progetti e consegne

97

Progetti, attività, membri, tariffe e allocazioni — automatizza la delivery e sincronizza i dati di progetto.

Resourcing e capacità

11

Allocazioni, il bench, la finestra di pianificazione e i consuntivi — pianifica chi lavora su cosa, e rileggi cosa hanno fatto.

Fatturazione e pagamenti

49

Fatture, righe, pagamenti, promemoria e fatturazione elettronica (KSeF) — automatizza la fatturazione end-to-end.

Budget e spese

159

Budget, transazioni, costi, imposte e conti bancari — monitora la spesa e riconcilia automaticamente.

CRM — lead e trattative

78

Lead, trattative, pipeline e fasi — gestisci il funnel di vendita dai tuoi sistemi.

Clienti e controparte

34

Clienti, contatti e controparte — mantieni la sincronizzazione tra il tuo CRM e Flowtly.

HR e persone

87

Dipendenti, dipartimenti, posizioni, benefit e responsabilità — automatizza i flussi di dati HR.

Performance e valutazioni

31

Cicli di valutazione, modelli, domande e sessioni — gestisci le valutazioni delle performance in modo programmatico.

Tempo e presenze

67

Orario di lavoro, ferie, turni e festività — registra e leggi le presenze programmaticamente.

Recruitment & ATS

40

Candidati, attività di selezione, colloqui e pianificazione — collega il tuo ATS.

Proprietà e asset

50

Immobili, prenotazioni, asset, contatori e letture — gestisci i dati immobiliari tramite l'API.

Contratti e compliance

48

Accordi, contratti, allegati e piani di pagamento — automatizza i flussi contrattuali.

Documenti e firme

20

Documenti, archiviazione e richieste di firma elettronica — carica, organizza e firma i file.

Personalizzazione e tag

62

Attributi, set di attributi, regole e tag — estendi gli oggetti Flowtly con i tuoi campi personalizzati.

Organizzazione e configurazione

48

Organizzazione, sedi, utenti, integrazioni e abbonamento — configura lo spazio di lavoro.

Utenti e accessi

16

Utenti e gruppi di permessi — gestisci chi può vedere e fare cosa.

Webhook e audit

14

Webhook e log di audit — reagisci agli eventi e traccia i cambiamenti.

Esportazioni contabili

16

Esportazioni 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.