API-referentie
De Flowtly REST API — 927 endpoints verdeeld over 192 resources, gegenereerd uit het actuele OpenAPI-schema.
Deze referentie wordt gegenereerd op basis van het API-schema. Veldbeschrijvingen en tekst die nog niet is vertaald, worden in het Engels weergegeven.
Voordat u gaat bouwen
Authenticatie
Stuur een persoonlijk toegangstoken mee in de header Authorization: Bearer <token>. Maak er een aan in Flowtly op de pagina Beveiliging van uw profiel. Een token handelt met uw eigen rechten, is 365 dagen geldig tenzij u anders kiest (maximaal 730) en kan daar op elk moment worden ingetrokken.
Organisatieheader
Elk verzoek bevat ook een instance-header met de ID van de organisatie waarin u handelt. Zonder die header weigert de API het verzoek.
Verzoeken en antwoorden
Antwoorden zijn JSON-LD (application/ld+json) of gewone JSON (application/json). Updates gebruiken PATCH met application/merge-patch+json. Collecties worden gepagineerd met page en itemsPerPage, maximaal 500 items per pagina.
Versiebeheer
De API heeft geen versies in paden of headers: resources staan in de root, bijvoorbeeld https://api.flowtly.eu/projects. Het OpenAPI 3.1-document wordt gepubliceerd op https://api.flowtly.eu/docs.json.
Snelheidslimieten
Verzoeken kennen een snelheidslimiet. Schrijfverzoeken (POST, PUT, PATCH, DELETE) tellen per organisatie over een venster van vijf minuten, met een hogere limiet zodra de organisatie is geverifieerd of een abonnement heeft. Boven een limiet antwoordt de API met 429 Too Many Requests en een Retry-After-header met het aantal seconden dat u moet wachten. De limieten kunnen veranderen, dus lees Retry-After in plaats van een getal vast te coderen.
Uitfasering
Een endpoint of veld dat wordt uitgefaseerd, is in het OpenAPI-document gemarkeerd als deprecated. De API stuurt geen uitfaseringsheaders, dus controleer het document wanneer u een integratie bijwerkt.
Uw integratie testen
Er is geen aparte sandbox. Test uw integratie in een proefomgeving met voorbeeldgegevens voordat u live gegevens koppelt. Zolang de organisatie niet is geverifieerd en geen abonnement heeft, draait een proefomgeving met een lagere schrijflimiet en verstuurt zij geen e-mail.
Wat er is gewijzigd
API-wijzigingen worden aangekondigd in de release notes, samen met de rest van het product.
Lees de release notesProjecten & aflevering
97Projecten, taken, leden, tarieven en allocaties — automatiseer levering en synchroniseer projectgegevens.
Resourcing & capaciteit
11Allocaties, de bench, het planningsvenster en de realisatie — plan wie aan wat werkt, en lees terug wat ze hebben gedaan.
Facturering & betalingen
49Facturen, factuurregels, betalingen, herinneringen en e-facturatie (KSeF) — automatiseer facturatie van begin tot eind.
Budgetten & uitgaven
159Budgetten, transacties, kosten, belastingen en bankrekeningen — volg uitgaven en verzoen automatisch.
CRM — leads & deals
78Leads, deals, pipelines en fases — stuur de salesfunnel aan vanuit je eigen systemen.
Klanten & tegenpartijen
34Klanten, contacten en tegenpartijen — houd je CRM en Flowtly gesynchroniseerd.
HR & personeelszaken
87Medewerkers, afdelingen, functies, voordelen en verantwoordelijkheden — automatiseer HR-gegevensstromen.
Prestaties & beoordelingen
31Beoordelingscycli, sjablonen, vragen en sessies — voer functioneringsgesprekken programmatisch uit.
Tijd & aanwezigheid
67Werktijd, verlof, roosters en vakantiedagen — registreer en lees aanwezigheid programmatisch.
Werving & ATS
40Kandidaten, wervingstaken, interviews en planning — koppel je ATS.
Eigendom & activa
50Panden, boekingen, assets, meters en meterstanden — beheer vastgoedgegevens via de API.
Contracten & compliance
48Overeenkomsten, contracten, bijlagen en betalingsschema's — automatiseer contractworkflows.
Documenten & handtekeningen
20Documenten, opslag en e-handtekeningverzoeken — upload, organiseer en onderteken bestanden.
Aanpassing & tags
62Attributen, attribuutsets, regels en tags — breid Flowtly-objecten uit met je eigen velden.
Organisatie & configuratie
48Organisatie, locaties, gebruikers, integraties en abonnement — configureer de werkruimte.
Gebruikers & toegang
16Gebruikers en rechtengroepen — beheer wie wat kan zien en doen.
Webhooks & audit
14Webhooks en auditlogs — reageer op gebeurtenissen en volg wijzigingen.
Boekhoudexports
16Exports naar Wapro, Optima, Enova, Symfonia, MT940 en SEPA — lever gegevens aan bij je boekhouder.
MCP-server
Verbind AI-tools met Flowtly via het Model Context Protocol op mcp.flowtly.eu.