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 notes

Projecten & aflevering

97

Projecten, taken, leden, tarieven en allocaties — automatiseer levering en synchroniseer projectgegevens.

Resourcing & capaciteit

11

Allocaties, de bench, het planningsvenster en de realisatie — plan wie aan wat werkt, en lees terug wat ze hebben gedaan.

Facturering & betalingen

49

Facturen, factuurregels, betalingen, herinneringen en e-facturatie (KSeF) — automatiseer facturatie van begin tot eind.

Budgetten & uitgaven

159

Budgetten, transacties, kosten, belastingen en bankrekeningen — volg uitgaven en verzoen automatisch.

CRM — leads & deals

78

Leads, deals, pipelines en fases — stuur de salesfunnel aan vanuit je eigen systemen.

Klanten & tegenpartijen

34

Klanten, contacten en tegenpartijen — houd je CRM en Flowtly gesynchroniseerd.

HR & personeelszaken

87

Medewerkers, afdelingen, functies, voordelen en verantwoordelijkheden — automatiseer HR-gegevensstromen.

Prestaties & beoordelingen

31

Beoordelingscycli, sjablonen, vragen en sessies — voer functioneringsgesprekken programmatisch uit.

Tijd & aanwezigheid

67

Werktijd, verlof, roosters en vakantiedagen — registreer en lees aanwezigheid programmatisch.

Werving & ATS

40

Kandidaten, wervingstaken, interviews en planning — koppel je ATS.

Eigendom & activa

50

Panden, boekingen, assets, meters en meterstanden — beheer vastgoedgegevens via de API.

Contracten & compliance

48

Overeenkomsten, contracten, bijlagen en betalingsschema's — automatiseer contractworkflows.

Documenten & handtekeningen

20

Documenten, opslag en e-handtekeningverzoeken — upload, organiseer en onderteken bestanden.

Aanpassing & tags

62

Attributen, attribuutsets, regels en tags — breid Flowtly-objecten uit met je eigen velden.

Organisatie & configuratie

48

Organisatie, locaties, gebruikers, integraties en abonnement — configureer de werkruimte.

Gebruikers & toegang

16

Gebruikers en rechtengroepen — beheer wie wat kan zien en doen.

Webhooks & audit

14

Webhooks en auditlogs — reageer op gebeurtenissen en volg wijzigingen.

Boekhoudexports

16

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