Aller au contenu
Sur cette page

API Kworia

L'API REST Kworia donne un accès programmatique à la facturation, aux devis, clients, dépenses, paiements, à la facturation électronique (PEPPOL et réseaux nationaux), à la banque, au reporting et aux webhooks — tout ce que vous faites dans l'application, depuis vos propres systèmes.

URL de base

Environnement URL de base
Production https://kworia.com

Tous les points de terminaison sont sous /api/v1. Le versionnage est porté par l'URI ; toute rupture de compatibilité passera par un nouveau préfixe de version.

Vérification de santé (sans authentification) : GET /api/health.

Démarrage rapide

  1. Obtenez un jeton. Dans le panneau d'administration, ouvrez Organisation → Jetons API et créez un jeton API d'organisation avec les scopes nécessaires. (Pour des applications agissant au nom d'utilisateurs, utilisez plutôt OAuth 2.0 + PKCE.)
  2. Appelez l'API.
curl "https://kworia.com/api/v1/invoices" \
  -H "Authorization: Bearer VOTRE_JETON_API" \
  -H "X-Organization-Id: VOTRE_ID_ORGANISATION" \
  -H "Accept: application/json"
  1. Explorez. La référence complète des points de terminaison est dans la Référence API, générée depuis la même spécification OpenAPI que celle vérifiée par nos tests.

Plan de la documentation

Guide Contenu
Authentification Jetons API, OAuth 2.0 + PKCE, scopes, durées de vie
Organisations & multi-tenant L'en-tête X-Organization-Id, portées des jetons
Pagination Enveloppes de liste, page / per_page
Erreurs Codes de statut et enveloppes d'erreur
Limites de débit Limites et en-têtes de throttling
Webhooks Abonnements aux événements, signatures
Journal des modifications & feuille de route Ce qui change, ce qui arrive

Spécification machine & collection client

  • Spécification OpenAPI 3.1 : openapi.yaml à la racine du dépôt — importable dans vos outils.
  • Collection Bruno : bruno/encryptinvoice-api/ — ouvrez-la dans Bruno et renseignez les variables d'environnement access_token / organization_id pour commencer.

Conventions en bref

  • Dates : horodatages ISO 8601 avec fuseau (2026-05-01T10:00:00+00:00) ; dates métier (issue_date, due_date) au format Y-m-d.
  • Montants : chaînes décimales ("1210.0000"), jamais des flottants ; la devise est un champ ISO 4217 séparé (3 lettres).
  • En-têtes : envoyez toujours Accept: application/json, et Content-Type: application/json pour les écritures.