Démarrer avec l'API

L'API REST de Hisab vous permet d'automatiser la facturation — créer des clients et des factures, les finaliser, exporter en PDF/XML, et plus — directement depuis vos propres systèmes.

Forfait requis : l'accès API est disponible sur les forfaits Professional et Fiduciaire.

1. Créer une clé API

Allez dans Paramètres → Clés API.
Cliquez sur Créer une clé API.
Donnez-lui un nom clair (ex. « Automatisation facturation »).
Sélectionnez les portées (scopes) nécessaires (principe du moindre privilège).
Validez, puis copiez la clé immédiatement — pour des raisons de sécurité, elle n'est affichée qu'une seule fois. Conservez-la dans un gestionnaire de secrets.

2. S'authentifier

Envoyez votre clé comme jeton Bearer. L'URL de base est :

https://hisab.ma/api/v1

Exemple — lister vos factures :


curl https://hisab.ma/api/v1/invoices \
  -H "Authorization: Bearer hisab_votre_cle_api"

3. Portées (scopes)

Groupe	Portées
Factures	read, write, finalize, send, payment, void, export
Factures récurrentes	read, write, delete
Clients	read, write, delete
Organisation	read, write
Webhooks	read, write

4. Créer une facture


curl -X POST https://hisab.ma/api/v1/invoices \
  -H "Authorization: Bearer hisab_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_...",
    "issue_date": "2026-06-03",
    "items": [
      { "description": "Conseil", "quantity": 10, "unit_price": 500, "tax_rate": 20 }
    ]
  }'

5. Utiliser le SDK officiel (Node.js / TypeScript)


npm install hisab-sdk


import { HisabClient } from 'hisab-sdk';

const hisab = new HisabClient({ apiKey: process.env.HISAB_API_KEY });

const invoices = await hisab.invoices.list({ status: 'paid' });

6. Webhooks

Pour réagir aux événements (ex. une facture payée), configurez des points de terminaison dans Paramètres → Webhooks. Hisab signe chaque envoi afin que vous puissiez vérifier son authenticité.

Remarques

Les requêtes sont limitées en débit ; en cas de dépassement vous recevez un 429 — patientez puis réessayez.
Gardez vos clés secrètes. En cas de fuite, révoquez-la depuis Paramètres → Clés API et créez-en une nouvelle.