Utvecklare
Frihet exponerar ett komplett REST API, ett webhooks-system och en MCP-server så att du kan integrera ditt ERP med vilket verktyg som helst. Automatisera arbetsflöden, synkronisera data med dina befintliga system eller bygg skräddarsydda integrationer. Se alla Frihets funktioner och tillgängliga integrationer.
Huvudresurser
REST API
RESTful API med autentisering via API-nyckel. Få programmatisk åtkomst till fakturor, utgifter, kunder, produkter, offerter och leverantörer.
- Kompletta CRUD-endpoints för 6 resurser (POST, GET, PUT/PATCH, DELETE)
- Filtrering efter status, datumintervall och paginering
- Finansiell dashboard (
/summary) med intäkter, utgifter och vinst - Särskilda åtgärder: ladda ner PDF, skicka via e-post, markera som betald
- Gräns på 100 förfrågningar/minut per nyckel
- Standardiserade JSON-svar med strikt validering (Zod)
Webhooks
Mottag realtidsnotifikationer när händelser inträffar i ditt Frihet-konto. 14 eventtyper med HMAC-SHA256-signatur för att verifiera äktheten av varje payload.
- 14 eventtyper (fakturor, utgifter, offerter, kunder, produkter)
- Kryptografisk signatur vid varje leverans
- Automatiska återförsök med exponentiell backoff
- Leveransloggar kan konsulteras från panelen
MCP-server
Officiell MCP-server publicerad på npm som @frihet/mcp-server (v1.5.1), registrerad som io.frihet/erp i MCP Registry. 52 verktyg för att integrera Frihet med AI-assistenter (Claude, Cursor, Windsurf).
- 52 verktyg, 11 resurser, 10 prompts (fakturor, utgifter, kunder, produkter, offerter, leverantörer, webhooks)
- Lokal (stdio) och fjärr (mcp.frihet.io) transport
- Strukturerad loggning, mätvärden per verktyg, automatisk rate-limit retry
- Autentisering via API-nyckel eller OAuth-flöde
- Open source (MIT) på GitHub
Skill för Claude Code
Officiell skill som lägger till affärsintelligens ovanpå MCP-servern. Konversationskommandon, spanskt skattekonsultkontext, arbetsflödesrecept och rapportformatering.
- Kommandon:
/frihet invoice,/frihet expense,/frihet report,/frihet clients - Automatisk förberedelse av blankett 303 (kvartalsvis moms)
- Månadsbokslut, uppföljning av förfallna skulder, konvertering offert-faktura
- Installation:
npx skills add Frihet-io/frihet-mcp
Stödda integrationer
Frihet ansluter sig nativt till följande verktyg. Varje integration kan kompletteras med REST API och webhooks för att täcka avancerade användningsfall.
| Kategori | Tjänst | Beskrivning |
|---|---|---|
| Pagos | Stripe | Prenumerationer och kundbetalningar via Stripe Billing |
| Pagos | Stripe Connect | Betalningslänkar för fakturor med kort, Apple Pay och Google Pay |
| Pagos | PayPal | Import av transaktioner och saldon via REST API v2 med OAuth2 |
| Pagos | GoCardless | SEPA autogirobetalningar, mandat och återkommande betalningar |
| Banca | Revolut Business | Automatisk import av transaktioner via API-nyckel |
| Banca | Plaid | Direkt bankanslutning via Plaid Link SDK för transaktioner och saldon |
| Banca | Open Banking | PSD2-anslutning med Salt Edge för banksynkronisering |
| E-commerce | Shopify | Import av order och produktsynkronisering via OAuth |
| E-commerce | WooCommerce | Dubbelriktad synkronisering av order och produkter via webhooks |
| E-commerce | Gumroad | Import av försäljning av digitala produkter med GR-prefix och deduplicering |
| E-commerce | Lemon Squeezy | Import av beställningar av digital programvara via JSON:API |
| Time tracking | Toggl | Import av tidsregistreringar för timfakturering |
| Time tracking | Clockify | Synkronisering av projekt och tidsregistreringar |
| Time tracking | Harvest | Import av timmar med Personal Access Token och Account ID |
| Productividad | Asana | Konsultation av projekt och uppgifter med automatisk identifiering av arbetsyta |
| Productividad | Trello | Åtkomst till tavlor, listor och kort för projektkontext |
| Productividad | Notion | Sökning efter sidor, databaser och poster i arbetsytan |
| Calendario | Google Calendar | Påminnelser om förfallodagar och faktureringshändelser |
| Calendario | Outlook Calendar | Händelser och förfallodagar via Microsoft Graph API med OAuth |
| Almacenamiento | Google Drive | Ladda upp, ladda ner och söka filer via OAuth |
| Comunicacion | Slack | Notifikationer om betalda fakturor, registrerade utgifter och varningar |
| Resend | Skicka fakturor via e-post med transaktionella mallar | |
| Automatizacion | n8n | Anslutning via webhooks för anpassade automatiseringsflöden |
| Automatizacion | Zapier | Anslutning till 6.000+ appar utan kod via webhooks |
| Automatizacion | Make | Visuell automatisering med hundratals appar via webhooks |
Säkerhet
Säkerhet är en prioritet i hela Frihets integrationslager.
- AES-256-GCM-kryptering för känslig lagrad data (integrationstoken, webhook-hemligheter)
- HMAC-SHA256 vid varje webhook-leverans för att verifiera payloadens äkthet
- SHA-256-hashning av API-nycklarna på servern -- den oformaterade nyckeln visas bara en gång vid skapandet
- Formatvalidering av API-nycklar innan de behandlas (prefix
fri_, längd 40-60 tecken, begränsad teckenuppsättning) - Rate limiting på 100 förfrågningar per minut per API-nyckel, stödd av Firestore (överlever cold starts)
- Strikt datavalidering med Zod — okända fält avvisas
- URL-validering i webhooks: endast HTTPS-endpoints tillåts (förutom localhost under utveckling)
- Blockering av privata IP-adresser för att förhindra SSRF i webhook-URL:er
- Validering av dokument-ID:n för att förhindra path traversal och injektion
- Token med konfigurerbar utgångstid -- du kan skapa nycklar med ett utgångsdatum
- Säkerhetshuvuden i alla svar:
X-Content-Type-Options,X-Frame-Options,X-XSS-Protection
SDK:er och CLI
Officiella SDK:er för att integrera Frihet i din stack:
| Paket | Installation | Beskrivning |
|---|---|---|
@frihet/sdk | npm i @frihet/sdk | TypeScript SDK — frihet.invoices.create(), kompletta typer, automatisk retry |
frihet | npm i -g frihet | CLI — frihet invoices list --status overdue |
| Python | Kommer snart | Under utveckling |
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 och kvoter
| Resurs | Gräns |
|---|---|
| API-förfrågningar | 100/minut per nyckel |
| Förfrågningsstorlek | 1 MB maximalt |
| Maximal offset | 10.000 |
| Webhook payload-storlek | 100 KB maximalt |
| Webhooks per konto | 20 maximalt |
| Webhook-återförsök | 3 försök per leverans |
| Resultat per sida | 100 maximalt (50 som standard) |
| Aktiva API-nycklar per användare | 5 maximalt (via OAuth) |
Kom igång
- Gå till Inställningar > Utvecklare > API-nycklar i ditt Frihet-konto
- Skapa en ny API-nyckel och kopiera nyckeln (visas bara en gång)
- Testa anslutningen med en GET-förfrågan till
/v1/clients - Konfigurera webhooks för att ta emot händelser i realtid
curl -s https://api.frihet.io/v1/clients \
-H "X-API-Key: fri_tu-clave-aqui" | head -c 200
Om svaret innehåller dina kunder fungerar integrationen. Se REST API-referensen för att se alla tillgängliga endpoints.