API REST de Frihet

Accès programmatique aux factures, clients, dépenses, produits et devis. Conçue pour des intégrations qui évoluent.

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

Conçue pour les développeurs

Mises à jour partielles PATCH

Mettez à jour uniquement les champs dont vous avez besoin. Les schémas partiels validés avec Zod garantissent l'intégrité.

Recherche et filtres

Recherche en texte intégral avec le paramètre ?q=. Mappage des champs par ressource pour des résultats précis.

Opérations par lots

Créez jusqu'à 50 ressources en une seule requête. Réponses HTTP 207 multi-statut.

Clés d'idempotence

Réessayez les requêtes en toute sécurité avec l'en-tête Idempotency-Key. TTL de 24 heures, supporté par Firestore.

En-têtes de limite de débit

X-RateLimit-Limit, Remaining et Reset dans chaque réponse. Planifiez en conséquence.

Spécification OpenAPI 3.1

Spécification lisible par machine dans /openapi.yaml. 16 chemins, 18 schémas. Génère des SDKs automatiquement.

Endpoints d'intelligence

Contexte métier, résumés mensuels et données fiscales trimestrielles via /context, /monthly, /quarterly.

Suppression sécurisée VeriFactu

Soft delete pour les factures et devis non brouillons. Traçabilité complète pour la conformité fiscale espagnole.

Endpoints

Method	Path	Description
GET	/v1/invoices	Lister les factures
POST	/v1/invoices	Créer une facture
PATCH	/v1/invoices/:id	Mettre à jour une facture
DELETE	/v1/invoices/:id	Supprimer une facture
POST	/v1/invoices/batch	Créer des factures par lots
GET	/v1/clients	Lister les clients
POST	/v1/clients	Créer un client
GET	/v1/expenses	Lister les dépenses
POST	/v1/expenses	Créer une dépense
GET	/v1/products	Lister les produits
GET	/v1/quotes	Lister les devis
GET	/v1/context	Contexte métier
GET	/v1/monthly	Résumé mensuel
GET	/v1/quarterly	Impôts trimestriels
GET	/openapi.yaml	Spécification OpenAPI

Exemples de code

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

Authentification

Générez des clés API depuis Paramètres > API dans votre tableau de bord Frihet. Incluez votre clé en tant que jeton Bearer dans l'en-tête Authorization.

Authorization: Bearer fri_...

Documentation complète de l'API MCP Server

Commencez à intégrer aujourd'hui

L'accès à l'API est inclus dans tous les plans. Votre clé API est prête dans Paramètres.

Démarrer Gratuitement