API & Webhooks (module optionnel)
Connectez Almawarid à votre site e-commerce, votre caisse ou votre SI : lire le stock, créer des factures, être notifié dès qu'une facture est payée.
Fonctions clés
- API REST authentifiée par token personnel (en-tête Authorization: Token …)
- Facturation : lister, créer et consulter des factures, gérer les clients
- Stock : catalogue produits avec quantité en temps réel, entrées et sorties
- RH : pointages, congés, présence temps réel
- Webhooks sortants signés HMAC-SHA256 — facture payée, changement de statut, client créé
- Intégration SI (plan Entreprise) : employés, feuilles de temps, congés
- Documentation interactive et token visibles sur /api-docs/ une fois connecté
Pour commencer
- Souscrivez au module API : contactez-nous, nous l'activons sur votre compte (aucune réinstallation).
- Connectez-vous et ouvrez **/api-docs/** : votre token personnel y est affiché.
- Testez : `curl -H "Authorization: Token VOTRE_TOKEN" https://almawarid.app/api/stock/products/`
- Pour être notifié en temps réel, déclarez une URL HTTPS : `POST /api/webhooks/` avec `{"url": "https://votre-site.dz/hooks", "events": "invoice.paid"}`.
- Conservez le **secret** renvoyé : il n'est affiché qu'une fois. Vérifiez chaque appel reçu en recalculant HMAC-SHA256(secret, corps brut) et en le comparant à l'en-tête `X-Almawarid-Signature`.
À noter : Module facturé à part, activable à la demande sur n'importe quel plan — il n'est inclus dans aucun abonnement. L'usage normal du logiciel (application mobile, poste de bureau, pointeuses biométriques) ne nécessite PAS ce module : il concerne uniquement l'accès programmatique depuis vos propres outils. Limites d'appel : 240 lectures et 60 écritures par minute et par token. Un webhook qui échoue 20 fois d'affilée se désactive automatiquement ; son état est visible via GET /api/webhooks/.
Modules liés
Essayez Almawarid gratuitement
Tous les modules inclus — sans carte bancaire.
Créer mon compte
