API EncryptInvoice
L'API REST EncryptInvoice 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://app.encryptinvoice.com |
| Staging | https://sandbox.encryptinvoice.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
- 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.)
- Appelez l'API.
curl "https://app.encryptinvoice.com/api/v1/invoices" \
-H "Authorization: Bearer VOTRE_JETON_API" \
-H "X-Organization-Id: VOTRE_ID_ORGANISATION" \
-H "Accept: application/json"
- 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'environnementaccess_token/organization_idpour 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 formatY-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, etContent-Type: application/jsonpour les écritures.