API-referens

Flowtlys REST-API — 927 slutpunkter fördelade på 192 resurser, genererade från det aktuella OpenAPI-schemat.

Den här referensen genereras från API-schemat. Fältbeskrivningar och text som ännu inte är översatt visas på engelska.

Innan du bygger

Autentisering

Skicka en personlig åtkomsttoken i headern Authorization: Bearer <token>. Skapa en i Flowtly på sidan Säkerhet i din profil. En token agerar med dina egna behörigheter, gäller i 365 dagar om du inte väljer annat (högst 730) och kan återkallas där när som helst.

Organisationsheader

Varje anrop har också en instance-header med ID:t för den organisation du agerar i. Utan den avvisar API:et anropet.

Anrop och svar

Svaren är JSON-LD (application/ld+json) eller vanlig JSON (application/json). Uppdateringar använder PATCH med application/merge-patch+json. Samlingar delas upp i sidor med page och itemsPerPage, högst 500 poster per sida.

Versionshantering

API:et är inte versionshanterat i sina sökvägar eller headers: resurserna ligger i roten, till exempel https://api.flowtly.eu/projects. OpenAPI 3.1-dokumentet publiceras på https://api.flowtly.eu/docs.json.

Hastighetsgränser

Anrop är hastighetsbegränsade. Skrivanrop (POST, PUT, PATCH, DELETE) räknas per organisation över ett fem minuters fönster, med en högre gräns när organisationen är verifierad eller har en prenumeration. Över en gräns svarar API:et 429 Too Many Requests med en Retry-After-header som anger hur många sekunder du ska vänta. Gränserna kan ändras, så läs Retry-After i stället för att hårdkoda ett tal.

Utfasningar

En endpoint eller ett fält som fasas ut markeras som deprecated i OpenAPI-dokumentet. API:et skickar inga utfasningsheaders, så kontrollera dokumentet när du uppdaterar en integration.

Testa din integration

Det finns ingen separat sandbox. Testa din integration i en provmiljö med exempeldata innan du kopplar på skarpa data. Tills organisationen är verifierad eller har en prenumeration körs en provperiod med en lägre skrivgräns och skickar ingen e-post.

Vad som har ändrats

API-ändringar kungörs i versionsanteckningarna, tillsammans med resten av produkten.

Läs versionsanteckningarna

Projekt & leverans

97

Projekt, uppgifter, medlemmar, priser och allokeringar — automatisera leverans och synka projektdata.

Resursplanering och kapacitet

11

Allokeringar, resursbänken, schemafönstret och utfallet — planera vem som arbetar med vad, och läs av vad de faktiskt gjorde.

Fakturering & betalningar

49

Fakturor, rader, betalningar, påminnelser och e-fakturering (KSeF) — automatisera faktureringen från början till slut.

Budgetar & utgifter

159

Budgetar, transaktioner, kostnader, skatt och bankkonton — följ upp utgifter och stäm av automatiskt.

CRM — leads och affärer

78

Leads, affärer, pipelines och steg — driv säljtratten från era egna system.

Klienter & motparter

34

Klienter, kontakter och motparter — håll din CRM och Flowtly synkroniserad.

HR och personal

87

Medarbetare, avdelningar, befattningar, förmåner och ansvarsområden — automatisera HR-dataflöden.

Prestation och utvärderingar

31

Utvärderingscykler, mallar, frågor och sessioner — kör prestationsutvärderingar programmatiskt.

Tid och närvaro

67

Arbetstid, ledighet, scheman och helgdagar — logga och läs närvaro programmässigt.

Rekrytering och ATS

40

Kandidater, rekryteringsuppgifter, intervjuer och bokningar — koppla ditt ATS.

Egendom och tillgångar

50

Fastigheter, bokningar, tillgångar, mätare och avläsningar — hantera fastighetsdata via API:et.

Kontrakt och efterlevnad

48

Överenskommelser, avtal, bilagor och betalningsplaner — automatisera avtalsflöden.

Dokument och signaturer

20

Dokument, lagring och e-signeringsförfrågningar — ladda upp, organisera och signera filer.

Anpassning och taggar

62

Attribut, attributuppsättningar, regler och taggar — utöka Flowtlys objekt med egna fält.

Organisation & konfiguration

48

Organisation, platser, användare, integrationer och prenumeration — konfigurera arbetsytan.

Användare och åtkomst

16

Användare och behörighetsgrupper — hantera vem som kan se och göra vad.

Webhooks & granskning

14

Webhooks och granskningsloggar — reagera på händelser och spåra ändringar.

Redovisningsexporter

16

Exporter till Wapro, Optima, Enova, Symfonia, MT940 och SEPA — lämna data till er redovisningskonsult.

MCP-server

Anslut AI-verktyg till Flowtly via Model Context Protocol på mcp.flowtly.eu.