Μετάβαση στο περιεχόμενο

API REST της Frihet

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

https://api.frihet.io/v1 v1 — 2026-03-18 OpenAPI 3.1 · 82 paths · 137 operations

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

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

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

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

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

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

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

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

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

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

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
GET /v1/invoices
POST /v1/invoices
PATCH /v1/invoices/:id
DELETE /v1/invoices/:id
POST /v1/invoices/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

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

                import { Frihet } from '@frihet/sdk';

const apiKey = process.env.FRIHET_API_KEY;
if (!apiKey) throw new Error('Set FRIHET_API_KEY before running this example');
const frihet = new Frihet({ apiKey });

// Follow each page's nextCursor until all paid invoices have been read.
let cursor: string | undefined;
do {
  const page = await frihet.invoices.list({ status: 'paid', limit: 25, cursor });
  for (const invoice of page.data) {
    console.log(invoice.documentNumber, invoice.total);
  }
  cursor = page.nextCursor;
} while (cursor);
              

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

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

Authorization: Bearer fri_...

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

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

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