API REST της Frihet

Προγραμματιστική πρόσβαση σε τιμολόγια, πελάτες, έξοδα, προϊόντα και προσφορές. Σχεδιασμένο για ενσωματώσεις που κλιμακώνονται.

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

Σχεδιασμένο για προγραμματιστές

Μερικές ενημερώσεις PATCH

Ενημερώστε μόνο τα πεδία που χρειάζεστε. Μερικά σχήματα επικυρωμένα με Zod διασφαλίζουν την ακεραιότητα.

Αναζήτηση και φίλτρα

Αναζήτηση πλήρους κειμένου με παράμετρο ?q=. Αντιστοίχιση πεδίων ανά πόρο για ακριβή αποτελέσματα.

Λειτουργίες batch

Δημιουργήστε έως και 50 πόρους σε μία μόνο αίτηση. Απαντήσεις HTTP 207 multi-status.

Κλειδιά ιδιοδυναμίας

Επαναλάβετε αιτήσεις με ασφάλεια χρησιμοποιώντας την κεφαλίδα Idempotency-Key. TTL 24 ωρών, υποστηριζόμενο από το Firestore.

Κεφαλίδες ορίου ρυθμού

X-RateLimit-Limit, Remaining και Reset σε κάθε απάντηση. Σχεδιάστε ανάλογα.

Προδιαγραφή OpenAPI 3.1

Προδιαγραφή αναγνώσιμη από μηχανές στο /openapi.yaml. 16 paths, 18 schemas. Δημιουργεί SDKs αυτόματα.

Endpoints ευφυΐας

Πλαίσιο επιχείρησης, μηνιαίες περιλήψεις και τριμηνιαία φορολογικά δεδομένα μέσω /context, /monthly, /quarterly.

Ασφαλής διαγραφή VeriFactu

Soft delete για τιμολόγια και προσφορές που δεν είναι προσχέδια. Πλήρης ιχνηλασιμότητα για την ισπανική φορολογική συμμόρφωση.

Endpoints

Method	Path	Description
GET	/v1/invoices	Λίστα τιμολογίων
POST	/v1/invoices	Δημιουργία τιμολογίου
PATCH	/v1/invoices/:id	Ενημέρωση τιμολογίου
DELETE	/v1/invoices/:id	Διαγραφή τιμολογίου
POST	/v1/invoices/batch	Δημιουργία τιμολογίων σε batch
GET	/v1/clients	Λίστα πελατών
POST	/v1/clients	Δημιουργία πελάτη
GET	/v1/expenses	Λίστα εξόδων
POST	/v1/expenses	Δημιουργία εξόδου
GET	/v1/products	Λίστα προϊόντων
GET	/v1/quotes	Λίστα προσφορών
GET	/v1/context	Πλαίσιο επιχείρησης
GET	/v1/monthly	Μηνιαία περίληψη
GET	/v1/quarterly	Τριμηνιαίοι φόροι
GET	/openapi.yaml	Προδιαγραφή OpenAPI

Παραδείγματα κώδικα

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

Έλεγχος ταυτότητας

Δημιουργήστε κλειδιά API από Ρυθμίσεις > API στον πίνακα ελέγχου της Frihet. Συμπεριλάβετε το κλειδί σας ως Bearer token στην κεφαλίδα Authorization.

Authorization: Bearer fri_...

Πλήρης τεκμηρίωση API MCP Server

Ξεκινήστε την ενσωμάτωση σήμερα

Η πρόσβαση στο API περιλαμβάνεται σε όλα τα πακέτα. Το κλειδί API σας είναι έτοιμο στις Ρυθμίσεις.

Ξεκινήστε Δωρεάν