Référence API

Introduction

L’API Capnio permet de connecter votre système de caisse, votre logiciel comptable ou tout autre outil à Capnio. Toutes les données de votre établissement sont accessibles via cette API.

Caution

Cette section est technique. Elle est destinée aux développeurs ou aux prestataires informatiques qui intègrent Capnio avec d’autres systèmes.

Authentification

Toutes les requêtes API nécessitent une clé API envoyée dans le header Authorization.

curl -H "Authorization: Bearer VOTRE_CLE_API" \
     https://capnio.pro/api/v1/employees

Obtenir une clé API

1. Connectez-vous à Capnio
2. Allez dans Intégrations & API
3. Cliquez sur Générer une clé API
4. Copiez la clé et stockez-la en sécurité

Caution

Ne partagez jamais votre clé API publiquement. Si elle est compromise, générez-en une nouvelle immédiatement.

Endpoints principaux

Employés

Liste

GET /api/store-admin/employees?storeId=STORE_ID

Réponse :

{
  "employees": [
    {
      "id": "abc123",
      "firstName": "Marie",
      "lastName": "Dupont",
      "position": "Serveuse",
      "email": "marie@exemple.com",
      "status": "active"
    }
  ]
}

Détail

GET /api/store-admin/employees/abc123?storeId=STORE_ID

Pointages

GET /api/store-admin/clock-records?storeId=STORE_ID&date=2026-01-15

Réponse :

{
  "records": [
    {
      "employeeId": "abc123",
      "employeeName": "Marie Dupont",
      "clockIn": "2026-01-15T08:02:00Z",
      "clockOut": "2026-01-15T17:05:00Z",
      "status": "on_time"
    }
  ]
}

Produits & Stock

Liste produits

GET /api/store-admin/stock/products?storeId=STORE_ID

Mouvements

GET /api/store-admin/stock/movements?storeId=STORE_ID&type=OUT

Créer mouvement

POST /api/store-admin/stock/movements
Content-Type: application/json

{
  "storeId": "STORE_ID",
  "productId": "prod123",
  "type": "OUT",
  "quantity": 5,
  "reason": "Utilisation cuisine"
}

Finance

GET /api/store-admin/finance/daily-sales?storeId=STORE_ID&date=2026-01-15

HACCP

GET /api/store-admin/haccp/readings?storeId=STORE_ID&equipmentId=equip123

Codes de réponse

Code	Signification
200	Succès
201	Créé avec succès
400	Requête invalide (paramètre manquant)
401	Non autorisé (clé API invalide)
404	Ressource non trouvée
500	Erreur serveur

Limites

• 100 requêtes par minute par clé API
• Les données sont paginées par 50 résultats par défaut
• Utilisez ?page=2&limit=50 pour la pagination