Kehittäjät
Frihet tarjoaa kattavan REST API:n, webhook-järjestelmän ja MCP-palvelimen, jotta voit integroida ERP-järjestelmäsi minkä tahansa työkalun kanssa. Automatisoi työnkulkuja, synkronoi tietoja nykyisten järjestelmiesi kanssa tai rakenna räätälöityjä integraatioita. Tutustu kaikkiin Frihetin ominaisuuksiin ja saatavilla oleviin integraatioihin.
Tärkeimmät resurssit
REST API
RESTful API, jossa autentikointi API-avaimella. Käytä laskuja, kuluja, asiakkaita, tuotteita, tarjouksia ja toimittajia ohjelmallisesti.
- Täydelliset CRUD-päätepisteet 6 resurssille (POST, GET, PUT/PATCH, DELETE)
- Suodatus tilan, päivämääräalueen ja sivutuksen perusteella
- Taloudellinen hallintapaneeli (
/summary) tuloilla, kuluilla ja voitolla - Erityistoiminnot: lataa PDF, lähetä sähköpostilla, merkitse maksetuksi
- Raja 100 pyyntöä/minuutti per avain
- Standardoidut JSON-vastaukset tiukalla validoinnilla (Zod)
Webhookit
Vastaanota reaaliaikaisia ilmoituksia, kun tililläsi tapahtuu Frihetissä. 14 tapahtumatyyppiä HMAC-SHA256-allekirjoituksella jokaisen payloadin aitouden varmistamiseksi.
- 14 tapahtumatyyppiä (laskut, kulut, tarjoukset, asiakkaat, tuotteet)
- Kryptografinen allekirjoitus jokaisessa toimituksessa
- Automaattiset uudelleenyritykset eksponentiaalisella viiveellä
- Hallintapaneelista selattavat toimituslokit
MCP-palvelin
Virallinen MCP-palvelin julkaistu npm:ssä nimellä @frihet/mcp-server (v1.5.1), rekisteröity nimellä io.frihet/erp MCP Registryssä. 52 työkalua Frihetin integroimiseksi tekoälyavustajien kanssa (Claude, Cursor, Windsurf).
- 52 työkalua, 11 resurssia, 10 kehotusta (laskut, kulut, asiakkaat, tuotteet, tarjoukset, toimittajat, webhookit)
- Paikallinen (stdio) ja etä (mcp.frihet.io) kuljetus
- Jäsennelty lokitus, työkalukohtaiset mittarit, automaattinen rate-limit uudelleenyritys
- Autentikointi API-avaimella tai OAuth-virtauksella
- Avoin lähdekoodi (MIT) GitHubissa
Claude Coden taito
Virallinen taito, joka lisää liiketoimintatietoa MCP-palvelimeen. Keskustelevia komentoja, espanjalainen verokonteksti, työnkulkureseptejä ja raporttien muotoilua.
- Komennot:
/frihet invoice,/frihet expense,/frihet report,/frihet clients - Automaattinen Modelo 303:n (ALV neljännesvuosittain) valmistelu
- Kuukausisulku, viivästyneiden maksujen seuranta, tarjous-lasku muuntaminen
- Asennus:
npx skills add Frihet-io/frihet-mcp
Tuetut integraatiot
Frihet yhdistyy natiivisti seuraaviin työkaluihin. Jokaista integraatiota voidaan täydentää REST API:lla ja webhoookeilla edistyneempien käyttötapausten kattamiseksi.
| Kategoria | Palvelu | Kuvaus |
|---|---|---|
| Maksut | Stripe | Tilausmaksut ja asiakaslaskutus Stripe Billingin kautta |
| Maksut | Stripe Connect | Laskujen maksulinkit kortilla, Apple Paylla ja Google Paylla |
| Maksut | PayPal | Tapahtumien ja saldojen tuonti REST API v2:n kautta OAuth2:lla |
| Maksut | GoCardless | SEPA-suoraveloitukset, valtuutukset ja toistuvat maksut |
| Pankki | Revolut Business | Automaattinen tapahtumien tuonti API-avaimella |
| Pankki | Plaid | Suora pankkiyhteys Plaid Link SDK:n kautta tapahtumiin ja saldoihin |
| Pankki | Open Banking | PSD2-yhteys Salt Edgen kanssa pankkisynkronointia varten |
| Verkkokauppa | Shopify | Tilausten tuonti ja tuotesynkronointi OAuthin kautta |
| Verkkokauppa | WooCommerce | Kaksisuuntainen tilausten ja tuotteiden synkronointi webhoookien kautta |
| Verkkokauppa | Gumroad | Digitaalisten tuotteiden myyntien tuonti GR-etuliitteellä ja deduplikoinnilla |
| Verkkokauppa | Lemon Squeezy | Digitaalisten ohjelmistotilausten tuonti JSON:API:n kautta |
| Ajanseuranta | Toggl | Aikaleimausten tuonti tuntiperusteiseen laskutukseen |
| Ajanseuranta | Clockify | Projektien ja aikaleimausten synkronointi |
| Ajanseuranta | Harvest | Tuntien tuonti Personal Access Tokenilla ja Account ID:llä |
| Tuottavuus | Asana | Projektien ja tehtävien haku automaattisella työtilan tunnistuksella |
| Tuottavuus | Trello | Pääsy tauluihin, listoihin ja kortteihin projektikontekstia varten |
| Tuottavuus | Notion | Sivujen, tietokantojen ja työtilan tietueiden haku |
| Kalenteri | Google Calendar | Erääntymismuistutukset ja laskutustapahtumat |
| Kalenteri | Outlook Calendar | Tapahtumat ja erääntymiset Microsoft Graph API:n kautta OAuthilla |
| Tallennustila | Google Drive | Tiedostojen lataus, nouto ja haku OAuthin kautta |
| Viestintä | Slack | Ilmoitukset maksetuista laskuista, kirjatuista kuluista ja hälytyksistä |
| Sähköposti | Resend | Laskujen lähettäminen sähköpostilla transaktio-templateilla |
| Automaatio | n8n | Yhteys webhoookien kautta mukautettuja automaatiovirtoja varten |
| Automaatio | Zapier | Yhteys yli 6000 koodittomaan sovellukseen webhoookien kautta |
| Automaatio | Make | Visuaalinen automaatio satojen sovellusten kanssa webhoookien kautta |
Turvallisuus
Turvallisuus on etusijalla kaikissa Frihetin integraatiokerroksissa.
- AES-256-GCM-salaus tallennetuille arkaluonteisille tiedoille (integraatiotokenit, webhook-salaisuudet)
- HMAC-SHA256 jokaisessa webhook-toimituksessa payloadin aitouden varmistamiseksi
- SHA-256-hajautus API-avaimista palvelimella -- avain selväkielisenä näytetään vain kerran luotaessa
- API-avaimen muodon validointi ennen niiden käsittelyä (
fri_-etuliite, pituus 40-60 merkkiä, rajoitettu merkkijoukko) - Rate limiting 100 pyyntöä minuutissa per API-avain, Firestoren tukemana (selviää kylmäkäynnistyksistä)
- Tiukka tietojen validointi Zodilla – tuntemattomat kentät hylätään
- URL-validointi webhoookeissa: vain HTTPS-päätepisteet sallitaan (paitsi localhost kehityksessä)
- Yksityisten IP-osoitteiden esto SSRF:n estämiseksi webhook-URL-osoitteissa
- Asiakirja-ID:iden validointi polkujen läpikävelyn ja injektion estämiseksi
- Tokenit konfiguroitavalla vanhenemisajalla – voit luoda avaimia vanhenemispäivämäärällä
- Turvallisuusotsakkeet kaikissa vastauksissa:
X-Content-Type-Options,X-Frame-Options,X-XSS-Protection
SDK:t ja CLI
Viralliset SDK:t Frihetin integroimiseksi järjestelmääsi:
| Paketti | Asennus | Kuvaus |
|---|---|---|
@frihet/sdk | npm i @frihet/sdk | TypeScript SDK – frihet.invoices.create(), täydelliset tyypit, automaattinen uudelleenyritys |
frihet | npm i -g frihet | CLI – frihet invoices list --status overdue |
| Python | Kehitteillä | Kehitteillä |
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
Rajat ja kiintiöt
| Resurssi | Raja |
|---|---|
| API-pyynnöt | 100/minuutti per avain |
| Pyyntöjen koko | 1 MB maksimi |
| Maksimi offset | 10.000 |
| Webhook-payloadin koko | 100 KB maksimi |
| Webhookit per tili | 20 maksimi |
| Webhookin uudelleenyritykset | 3 yritystä per toimitus |
| Tulokset per sivu | 100 maksimi (50 oletuksena) |
| Aktiiviset API-avaimet per käyttäjä | 5 maksimi (OAuthin kautta) |
Ensimmäiset vaiheet
- Siirry kohtaan Asetukset > Kehittäjät > API-avaimet Frihet-tililläsi
- Luo uusi API-avain ja kopioi avain (näytetään vain kerran)
- Testaa yhteyttä GET-pyynnöllä osoitteeseen
/v1/clients - Määritä webhookit vastaanottamaan tapahtumia reaaliaikaisesti
curl -s https://api.frihet.io/v1/clients \
-H "X-API-Key: fri_tu-clave-aqui" | head -c 200
Jos vastauksessa on asiakkaasi, integraatio toimii. Tutustu REST API -viitteeseen nähdäksesi kaikki saatavilla olevat päätepisteet.