API REST — Documentation

Intégrez 1invoice.online à vos propres systèmes. L'API suit les conventions REST et retourne du JSON. Stable sous /api/v1 — nous incrémentons la version pour les breaking changes.

Démarrage rapide

1. Connectez-vous et allez dans Paramètres → API REST
2. Cliquez sur "Créer une clé", nommez-la et copiez la valeur (elle n'est affichée qu'une fois)
3. Envoyez la clé en tant qu'en-tête Authorization: Bearer 1iv_... dans vos requêtes

Authentification

Tous les endpoints exigent un token Bearer dans l'en-tête Authorization. Les clés sont liées à l'organisation où elles ont été créées — vous ne pouvez lire que les données de votre propre org.

Authorization: Bearer 1iv_<votre clé>

Réponses d'erreur

• 401 Unauthorized — en-tête manquant ou clé invalide/révoquée
• 500 Internal Server Error — erreur base de données ; réessayez ou contactez-nous

Discovery

GET /api/v1

Retourne la liste des endpoints disponibles. Pas de credentials nécessaires.

Membres

GET /api/v1/members?limit=50&offset=0&status=active

Retourne les membres de votre organisation. Paginé.

• limit — éléments par page (défaut 50, max 200)
• offset — position de départ (défaut 0)
• status — filtre sur active, inactive, pending

Devis

GET /api/v1/quotes?status=accepted

Retourne les devis avec statut, total, public_token et infos de signature.

Factures

GET /api/v1/invoices?status=paid

Retourne les factures avec statut de paiement et date d'échéance.

Webhooks

Enregistrez une URL sous Paramètres → Webhooks. Quand un événement survient, nous y POSTons du JSON avec ces en-têtes :

• X-1Invoice-Event — nom de l'événement (ex. invoice.paid)
• X-1Invoice-Signature — HMAC-SHA256 du body brut avec votre secret (hex)
• User-Agent: 1invoice-webhooks/1

Événements disponibles

• invoice.created, invoice.sent, invoice.paid
• quote.created, quote.sent, quote.accepted, quote.rejected

Rate limits

Limite douce : 60 appels/minute par clé. En surcharge vous recevez 429 Too Many Requests. Besoin de plus ? Écrivez-nous — nous pouvons relever sur demande.

Versioning

Nous utilisons le versioning par URL. /api/v1 est stable. Les breaking changes passent en /api/v2 avec au moins 6 mois de fonctionnement en parallèle.

Statut & changelog

Voir la feuille de route pour le statut actuel. Nous annonçons les changements d'API avec au moins 30 jours de préavis via les webhooks et une bannière dans le tableau de bord.

Questions sur les intégrations ?
Contactez-nous — nous vous accompagnons. La première intégration prend généralement moins d'une heure.