API REST Frihet

Programowy dostęp do faktur, klientów, wydatków, produktów i ofert. Zaprojektowana dla integracji, które skalują.

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

Stworzona dla deweloperów

Częściowe aktualizacje PATCH

Aktualizuj tylko te pola, których potrzebujesz. Częściowe schematy zweryfikowane za pomocą Zod gwarantują integralność.

Wyszukiwanie i filtry

Wyszukiwanie pełnotekstowe z parametrem ?q=. Mapowanie pól według zasobu dla precyzyjnych wyników.

Operacje wsadowe

Utwórz do 50 zasobów w jednym żądaniu. Odpowiedzi HTTP 207 multi-status.

Klucze idempotencji

Ponawiaj bezpiecznie żądania z nagłówkiem Idempotency-Key. TTL 24 godziny, wspierane przez Firestore.

Nagłówki limitu szybkości

X-RateLimit-Limit, Remaining i Reset w każdej odpowiedzi. Planuj odpowiednio.

Specyfikacja OpenAPI 3.1

Specyfikacja czytelna maszynowo w /openapi.yaml. 16 ścieżek, 18 schematów. Generuje SDK automatycznie.

Punkty końcowe inteligencji

Kontekst biznesowy, miesięczne podsumowania i kwartalne dane podatkowe poprzez /context, /monthly, /quarterly.

Bezpieczne usuwanie VeriFactu

Soft delete dla faktur i ofert, które nie są robocze. Pełna identyfikowalność dla zgodności podatkowej w Hiszpanii.

Punkty końcowe

Method	Path	Description
GET	/v1/invoices	Lista faktur
POST	/v1/invoices	Utwórz fakturę
PATCH	/v1/invoices/:id	Zaktualizuj fakturę
DELETE	/v1/invoices/:id	Usuń fakturę
POST	/v1/invoices/batch	Twórz faktury wsadowo
GET	/v1/clients	Lista klientów
POST	/v1/clients	Utwórz klienta
GET	/v1/expenses	Lista wydatków
POST	/v1/expenses	Utwórz wydatek
GET	/v1/products	Lista produktów
GET	/v1/quotes	Lista ofert
GET	/v1/context	Kontekst biznesowy
GET	/v1/monthly	Miesięczne podsumowanie
GET	/v1/quarterly	Podatki kwartalne
GET	/openapi.yaml	Specyfikacja OpenAPI

Przykłady kodu

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']

Uwierzytelnianie

Generuj klucze API z Ustawień > API w swoim panelu Frihet. Dołącz swój klucz jako token Bearer w nagłówku Authorization.

Authorization: Bearer fri_...

Pełna dokumentacja API MCP Server

Zacznij integrować już dziś

Dostęp do API wliczony we wszystkie plany. Twój klucz API jest gotowy w Ustawieniach.

Zacznij za darmo