Frihetin REST API

Ohjelmallinen pääsy laskuihin, asiakkaisiin, kuluihin, tuotteisiin ja tarjouksiin. Suunniteltu skaalautuville integraatioille.

https://api.frihet.io/v1 v1 — 2026-03-18

Suunniteltu kehittäjille

Osittaiset PATCH-päivitykset

Päivitä vain tarvitsemasi kentät. Zodilla validoidut osittaiset skeemat takaavat eheyden.

Haku ja suodattimet

Koko tekstin haku parametrilla ?q=. Kenttien kartoitus resurssin mukaan tarkkojen tulosten saamiseksi.

Batch-operaatiot

Luo jopa 50 resurssia yhdellä pyynnöllä. HTTP 207 multi-status -vastaukset.

Idempotenssiavaimet

Yritä pyyntöjä uudelleen turvallisesti Idempotency-Key-otsikolla. TTL 24 tuntia, Firestoren tukema.

Nopeusrajoitusotsikot

X-RateLimit-Limit, Remaining ja Reset jokaisessa vastauksessa. Suunnittele sen mukaisesti.

OpenAPI 3.1 -määritys

Koneellisesti luettava määritys osoitteessa /openapi.yaml. 16 polkua, 18 skeemaa. Generoi SDK:t automaattisesti.

Älykkäät päätepisteet

Liiketoimintaympäristö, kuukausittaiset yhteenvedot ja neljännesvuosittaiset verotiedot kautta /context, /monthly, /quarterly.

Turvallinen VeriFactu-poisto

Pehmytpoisto laskuille ja ei-luonnosmuotoisille tarjouksille. Täysi jäljitettävyys Espanjan verosäännösten noudattamiseksi.

Päätepisteet

Method	Path	Description
GET	/v1/invoices	Listaa laskut
POST	/v1/invoices	Luo lasku
PATCH	/v1/invoices/:id	Päivitä lasku
DELETE	/v1/invoices/:id	Poista lasku
POST	/v1/invoices/batch	Luo laskuja erässä
GET	/v1/clients	Listaa asiakkaat
POST	/v1/clients	Luo asiakas
GET	/v1/expenses	Listaa kulut
POST	/v1/expenses	Luo kulu
GET	/v1/products	Listaa tuotteet
GET	/v1/quotes	Listaa tarjoukset
GET	/v1/context	Liiketoimintaympäristö
GET	/v1/monthly	Kuukausiyhteenveto
GET	/v1/quarterly	Neljännesvuosittaiset verot
GET	/openapi.yaml	OpenAPI-määritys

Koodiesimerkit

curl https://api.frihet.io/v1/invoices \
  -H "Authorization: Bearer fri_..." \
  -H "Content-Type: application/json"

const res = await fetch('https://api.frihet.io/v1/invoices', {
  headers: {
    'Authorization': 'Bearer fri_...',
    'Content-Type': 'application/json',
  },
});
const { data, meta } = await res.json();

import requests

res = requests.get(
    'https://api.frihet.io/v1/invoices',
    headers={'Authorization': 'Bearer fri_...'}
)
data = res.json()['data']

Todennus

Luo API-avaimia kohdasta Asetukset > API Frihet-hallintapaneelissasi. Sisällytä avaimesi Bearer-tunnuksena Authorization-otsikkoon.

Authorization: Bearer fri_...

Kattava API-dokumentaatio MCP Server

Aloita integrointi tänään

API-käyttö sisältyy kaikkiin tilauksiin. API-avaimesi on valmis Asetuksissa.

Aloita ilmaiseksi