Utviklere
Frihet tilbyr en komplett REST API, et webhook-system og en MCP-server slik at du kan integrere ditt ERP med hvilket som helst verktøy. Automatiser arbeidsflyter, synkroniser data med dine eksisterende systemer eller bygg skreddersydde integrasjoner. Se alle Frihet-funksjoner og tilgjengelige integrasjoner.
Hovedressurser
REST API
RESTful API med autentisering med API-nøkkel. Få programmatisk tilgang til fakturaer, utgifter, kunder, produkter, tilbud og leverandører.
- Komplette CRUD-endepunkter for 6 ressurser (POST, GET, PUT/PATCH, DELETE)
- Filtrering etter status, datointervall og paginering
- Finansielt dashbord (
/summary) med inntekter, utgifter og fortjeneste - Spesielle handlinger: last ned PDF, send via e-post, marker som betalt
- Grense på 100 forespørsler/minutt per nøkkel
- Standardiserte JSON-svar med streng validering (Zod)
Webhooks
Motta sanntidsvarsler når hendelser inntreffer på din Frihet-konto. 14 hendelsestyper med HMAC-SHA256 signatur for å verifisere autentisiteten til hver payload.
- 14 hendelsestyper (fakturaer, utgifter, tilbud, kunder, produkter)
- Kryptografisk signatur ved hver leveranse
- Automatiske gjenforsøk med eksponentiell backoff
- Leveringslogger som kan konsulteres fra panelet
MCP-server
Offisiell MCP-server publisert på npm som @frihet/mcp-server (v1.5.1), registrert som io.frihet/erp i MCP Registry. 52 verktøy for å integrere Frihet med AI-assistenter (Claude, Cursor, Windsurf).
- 52 verktøy, 11 ressurser, 10 prompter (fakturaer, utgifter, kunder, produkter, tilbud, leverandører, webhooks)
- Lokal (stdio) og ekstern (mcp.frihet.io) transport
- Strukturert logging, metrikker per verktøy, automatisk rate-limit gjenforsøk
- Autentisering via API-nøkkel eller OAuth-flyt
- Åpen kildekode (MIT) på GitHub
Skill for Claude Code
Offisiell skill som legger til forretningsintelligens over MCP-serveren. Samtalekommandoer, spansk skattekontekst, oppskrifter for arbeidsflyter og rapportformattering.
- Kommandoer:
/frihet invoice,/frihet expense,/frihet report,/frihet clients - Automatisk forberedelse av Model 303 (kvartalsvis mva)
- Månedlig avslutning, oppfølging av forfalne betalinger, konvertering fra tilbud til faktura
- Installasjon:
npx skills add Frihet-io/frihet-mcp
Støttede integrasjoner
Frihet kobler seg naturlig til følgende verktøy. Hver integrasjon kan suppleres med REST API og webhooks for å dekke avanserte bruksområder.
| Kategori | Tjeneste | Beskrivelse |
|---|---|---|
| Betalinger | Stripe | Abonnementer og kundebetalinger via Stripe Billing |
| Betalinger | Stripe Connect | Betalingslenker for fakturaer med kort, Apple Pay og Google Pay |
| Betalinger | PayPal | Import av transaksjoner og saldoer via REST API v2 med OAuth2 |
| Betalinger | GoCardless | SEPA direkte belastning, mandater og gjentakende betalinger |
| Bank | Revolut Business | Automatisk import av transaksjoner via API-nøkkel |
| Bank | Plaid | Direkte banktilkobling via Plaid Link SDK for transaksjoner og saldoer |
| Bank | Open Banking | PSD2-tilkobling med Salt Edge for banksynkronisering |
| E-handel | Shopify | Import av bestillinger og produktsynkronisering via OAuth |
| E-handel | WooCommerce | Toveis synkronisering av bestillinger og produkter via webhooks |
| E-handel | Gumroad | Import av salg av digitale produkter med GR-prefiks og deduplisering |
| E-handel | Lemon Squeezy | Import av digitale programvarebestillinger via JSON:API |
| Tidssporing | Toggl | Import av tidsregistreringer for timefakturering |
| Tidssporing | Clockify | Synkronisering av prosjekter og tidsregistreringer |
| Tidssporing | Harvest | Import av timer med Personal Access Token og Account ID |
| Produktivitet | Asana | Konsultasjon av prosjekter og oppgaver med automatisk arbeidsområdedeteksjon |
| Produktivitet | Trello | Tilgang til tavler, lister og kort for prosjektkontekst |
| Produktivitet | Notion | Søk etter sider, databaser og oppføringer i arbeidsområdet |
| Kalender | Google Calendar | Forfallsminnelser og faktureringshendelser |
| Kalender | Outlook Calendar | Hendelser og forfall via Microsoft Graph API med OAuth |
| Lagring | Google Drive | Last opp, last ned og søk etter filer via OAuth |
| Kommunikasjon | Slack | Varsler om betalte fakturaer, registrerte utgifter og varsler |
| E-post | Resend | Sending av fakturaer via e-post med transaksjonsmaler |
| Automatisering | n8n | Tilkobling via webhooks for tilpassede automatiseringsflyter |
| Automatisering | Zapier | Tilkobling med 6.000+ apper uten kode via webhooks |
| Automatisering | Make | Visuell automatisering med hundrevis av apper via webhooks |
Sikkerhet
Sikkerhet er en prioritet i hele Frihets integrasjonslag.
- AES-256-GCM kryptering for lagrede sensitive data (integrasjonstokener, webhook-hemmeligheter)
- HMAC-SHA256 ved hver webhook-leveranse for å verifisere payload-autentisiteten
- SHA-256 hashing av API-nøklene på serveren – nøkkelen i ren tekst vises kun én gang ved opprettelse
- Formatvalidering av API-nøkler før behandling (prefiks
fri_, lengde 40-60 tegn, begrenset tegnsett) - Rate limiting på 100 forespørsler per minutt per API-nøkkel, støttet av Firestore (overlever cold starts)
- Streng datavalidering med Zod — ukjente felt avvises
- URL-validering i webhooks: kun HTTPS-endepunkter er tillatt (unntatt localhost i utvikling)
- Blokkering av private IP-er for å unngå SSRF i webhook-URL-ene
- Validering av dokument-IDer for å forhindre path traversal og injeksjon
- Tokener med konfigurerbar utløpstid — du kan opprette nøkler med utløpsdato
- Sikkerhetshodefelt i alle svar:
X-Content-Type-Options,X-Frame-Options,X-XSS-Protection
SDK-er og CLI
Offisielle SDK-er for å integrere Frihet i din stack:
| Pakke | Installasjon | Beskrivelse |
|---|---|---|
@frihet/sdk | npm i @frihet/sdk | TypeScript SDK — frihet.invoices.create(), fullstendige typer, automatisk gjenforsøk |
frihet | npm i -g frihet | CLI — frihet invoices list --status overdue |
| Python | Kommer snart | Under utvikling |
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 }],
});
Repositorio: github.com/Frihet-io/frihet-sdk
Grenser og kvoter
| Ressurs | Grense |
|---|---|
| API-forespørsler | 100/minutt per nøkkel |
| Forespørselsstørrelse | 1 MB maksimum |
| Maksimal offset | 10.000 |
| Webhook payload-størrelse | 100 KB maksimum |
| Webhooks per konto | 20 maksimum |
| Webhook gjenforsøk | 3 forsøk per leveranse |
| Resultater per side | 100 maksimum (50 som standard) |
| Aktive API-nøkler per bruker | 5 maksimum (via OAuth) |
Første skritt
- Gå til Innstillinger > Utviklere > API-nøkler i din Frihet-konto
- Opprett en ny API-nøkkel og kopier nøkkelen (vises kun én gang)
- Test tilkoblingen med en GET-forespørsel til
/v1/clients - Konfigurer webhooks for å motta sanntidshendelser
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 integrasjonen. Se REST API-referansen for å se alle tilgjengelige endepunkter.