L'API est un produit

API développeurs CEMAC POS

Une API REST versionnée (/api/v1), authentifiée par jetons (Sanctum), multi-boutiques. Construisez vos intégrations : produits, clients, ventes, fidélité, rapports et synchronisation hors-ligne.

Référence interactive (Try it out) OpenAPI Postman Kit API (zip)

Authentification

POST /api/v1/auth/login renvoie un jeton Bearer.

Ressources

Produits, catégories, clients, ventes — CRUD complet.

Synchronisation

Endpoints pull/push pour les clients hors-ligne.

Démarrage rapide

# 1. Obtenir un jeton
curl -X POST https://cemacpos.com/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"owner@cemacpos.cm","password":"password"}'

# 2. Lister les produits
curl https://cemacpos.com/api/v1/products \
  -H "Authorization: Bearer <TOKEN>"

# 3. Enregistrer une vente
curl -X POST https://cemacpos.com/api/v1/sales \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"product_id":"<ID>","quantity":2}],
       "payments":[{"method":"mtn_momo","amount_xaf":7000}]}'

Points d'entrée principaux

Méthode	Chemin	Description
POST	/api/v1/auth/register	Créer une boutique (essai)
POST	/api/v1/auth/login	Obtenir un jeton
GET	/api/v1/products	Lister / rechercher les produits
GET	/api/v1/customers	Lister les clients & fidélité
POST	/api/v1/sales	Enregistrer une vente
GET	/api/v1/sales/{id}/receipt	Ticket ESC/POS (58/80 mm)
GET	/api/v1/reports/z	Rapport Z journalier
GET	/api/v1/sync/pull	Récupérer les deltas hors-ligne
POST	/api/v1/sync/push	Envoyer les changements hors-ligne

Référence interactive complète : /api-docs. Toutes les requêtes sont multi-boutiques : un jeton ne voit que les données de sa boutique.