Udviklere
Frihet eksponerer et komplet REST API, et webhook-system og en MCP-server, så du kan integrere dit ERP med ethvert værktøj. Automatiser arbejdsgange, synkroniser data med dine eksisterende systemer, eller byg brugerdefinerede integrationer. Se alle Frihets funktioner og de tilgængelige integrationer.
Hovedressourcer
REST API
RESTful API med godkendelse via API-nøgle. Få programmatisk adgang til fakturaer, udgifter, kunder, produkter, tilbud og leverandører.
- Komplette CRUD-endpoints for 6 ressourcer (POST, GET, PUT/PATCH, DELETE)
- Filtrering efter status, datointerval og paginering
- Finansielt dashboard (
/summary) med indtægter, udgifter og fortjeneste - Særlige handlinger: download PDF, send via e-mail, marker som betalt
- Grænse på 100 forespørgsler/minut pr. nøgle
- Standardiserede JSON-svar med streng validering (Zod)
Webhooks
Modtag notifikationer i realtid, når der sker begivenheder på din Frihet-konto. 14 begivenhedstyper med HMAC-SHA256 signatur for at verificere ægtheden af hver payload.
- 14 begivenhedstyper (fakturaer, udgifter, tilbud, kunder, produkter)
- Kryptografisk signatur ved hver levering
- Automatiske genforsøg med eksponentiel backoff
- Leveringslogs, der kan forespørges fra panelet
MCP-server
Officiel MCP-server publiceret på npm som @frihet/mcp-server (v1.5.1), registreret som io.frihet/erp i MCP Registry. 52 værktøjer til at integrere Frihet med AI-assistenter (Claude, Cursor, Windsurf).
- 52 værktøjer, 11 ressourcer, 10 prompts (fakturaer, udgifter, kunder, produkter, tilbud, leverandører, webhooks)
- Lokal (stdio) og fjern (mcp.frihet.io) transport
- Struktureret logging, metrikker pr. værktøj, automatisk rate-limit genforsøg
- Godkendelse via API-nøgle eller OAuth-flow
- Open source (MIT) på GitHub
Skill til Claude Code
Officiel skill, der tilføjer forretningsintelligens oven på MCP-serveren. Konversationelle kommandoer, spansk skattekontekst, arbejdsgangopskrifter og rapportformatering.
- Kommandoer:
/frihet invoice,/frihet expense,/frihet report,/frihet clients - Automatisk forberedelse af Model 303 (kvartalsvis moms)
- Månedlig afslutning, opfølgning på skyldnere, konvertering af tilbud til faktura
- Installation:
npx skills add Frihet-io/frihet-mcp
Understøttede integrationer
Frihet opretter forbindelse native til følgende værktøjer. Hver integration kan suppleres med REST API'et og webhooks for at dække avancerede brugsscenarier.
| Kategori | Tjeneste | Beskrivelse |
|---|---|---|
| Betalinger | Stripe | Abonnementer og kundeopkrævninger via Stripe Billing |
| Betalinger | Stripe Connect | Betalingslinks til fakturaer med kort, Apple Pay og Google Pay |
| Betalinger | PayPal | Import af transaktioner og saldi via REST API v2 med OAuth2 |
| Betalinger | GoCardless | Opkrævninger via SEPA-bankoverførsel, mandater og tilbagevendende betalinger |
| Bank | Revolut Business | Automatisk import af transaktioner via API-nøgle |
| Bank | Plaid | Direkte bankforbindelse via Plaid Link SDK for transaktioner og saldi |
| Bank | Open Banking | PSD2-forbindelse med Salt Edge for banksynkronisering |
| E-handel | Shopify | Import af ordrer og synkronisering af produkter via OAuth |
| E-handel | WooCommerce | Tovejs synkronisering af ordrer og produkter via webhooks |
| E-handel | Gumroad | Import af salg af digitale produkter med GR-præfiks og deduplikering |
| E-handel | Lemon Squeezy | Import af digitale softwareordrer via JSON:API |
| Tidsregistrering | Toggl | Import af tidsregistreringer til timefakturering |
| Tidsregistrering | Clockify | Synkronisering af projekter og tidsregistreringer |
| Tidsregistrering | Harvest | Import af timer med Personal Access Token og Account ID |
| Produktivitet | Asana | Forespørgsel af projekter og opgaver med automatisk detektion af workspace |
| Produktivitet | Trello | Adgang til tavler, lister og kort for projektkontekst |
| Produktivitet | Notion | Søgning efter sider, databaser og registreringer af workspace |
| Kalender | Google Kalender | Forfaldspåmindelser og faktureringsbegivenheder |
| Kalender | Outlook Kalender | Begivenheder og forfaldsdatoer via Microsoft Graph API med OAuth |
| Lagring | Google Drive | Upload, download og søg efter filer via OAuth |
| Kommunikation | Slack | Notifikationer om betalte fakturaer, registrerede udgifter og advarsler |
| Resend | Afsendelse af fakturaer via e-mail med transaktionelle skabeloner | |
| Automatisering | n8n | Forbindelse via webhooks for tilpassede automatiseringsflows |
| Automatisering | Zapier | Forbindelse med 6.000+ apps uden kode via webhooks |
| Automatisering | Make | Visuel automatisering med hundredvis af apps via webhooks |
Sikkerhed
Sikkerhed er en prioritet i hele Frihets integrationslag.
- AES-256-GCM kryptering for lagrede følsomme data (integrationstokens, webhook-hemmeligheder)
- HMAC-SHA256 ved hver webhook-levering for at verificere payloadets ægthed
- SHA-256 hashing af API-nøgler på serveren -- den klare tekstnøgle vises kun én gang ved oprettelse
- Formatvalidering af API-nøgler før behandling (præfiks
fri_, længde 40-60 tegn, begrænset tegnsæt) - Rate limiting på 100 forespørgsler pr. minut pr. API-nøgle, understøttet af Firestore (overlever cold starts)
- Streng datavalidering med Zod — ukendte felter afvises
- URL-validering i webhooks: kun HTTPS-endpoints er tilladt (undtagen localhost under udvikling)
- Blokering af private IP'er for at undgå SSRF i webhook-URL'er
- Validering af dokument-ID'er for at forhindre path traversal og injektion
- Tokens med konfigurerbar udløbstid -- du kan oprette nøgler med udløbsdato
- Sikkerhedsoverskrifter i alle svar:
X-Content-Type-Options,X-Frame-Options,X-XSS-Protection
SDK'er og CLI
Officielle SDK'er til integration af Frihet i din stack:
| Pakke | Installation | Beskrivelse |
|---|---|---|
@frihet/sdk | npm i @frihet/sdk | TypeScript SDK — frihet.invoices.create(), komplette typer, automatisk genforsøg |
frihet | npm i -g frihet | CLI — frihet invoices list --status overdue |
| Python | Under udvikling | Under udvikling |
import Frihet from '@frihet/sdk';
const frihet = new Frihet({ apiKey: 'fri_...' });
const invoice = await frihet.invoices.create({
clientName: 'Acme Corp',
items: [{ description: 'Consulting', quantity: 10, unitPrice: 150 }],
});
Repository: github.com/Frihet-io/frihet-sdk
Grænser og kvoter
| Ressource | Grænse |
|---|---|
| API-forespørgsler | 100/minut pr. nøgle |
| Forespørgselsstørrelse | 1 MB maksimum |
| Maksimal offset | 10.000 |
| Webhook payload-størrelse | 100 KB maksimum |
| Webhooks pr. konto | 20 maksimum |
| Webhook genforsøg | 3 forsøg pr. levering |
| Resultater pr. side | 100 maksimum (50 som standard) |
| Aktive API-nøgler pr. bruger | 5 maksimum (via OAuth) |
Kom i gang
- Gå til Indstillinger > Udviklere > API-nøgler på din Frihet-konto
- Opret en ny API-nøgle, og kopiér nøglen (vises kun én gang)
- Test forbindelsen med en GET-anmodning til
/v1/clients - Konfigurer webhooks til at modtage begivenheder i realtid
curl -s https://api.frihet.io/v1/clients \
-H "X-API-Key: fri_tu-clave-aqui" | head -c 200
Hvis svaret inkluderer dine kunder, fungerer integrationen. Se REST API-referencen for at se alle tilgængelige endpoints.