Référence API

URL de base

https://api.klovio.app/v1

Authentification

Toutes les requêtes nécessitent un token Bearer. Générez des clés API dans Paramètres → Développeurs → Clés API. Les clés sont scopées par environnement (sandbox / production) et par rôle.

curl https://api.klovio.app/v1/inventory \
  -H "Authorization: Bearer klv_live_********************"

Limites de débit

Standard : 1 000 requêtes / minute / clé API
Endpoints en bulk : 100 requêtes / minute
Webhooks : Aucune limite sortante ; nous réessayons les livraisons échouées avec backoff exponentiel pendant 24 heures

Les headers de limite sont inclus dans chaque réponse : X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Ressources

Inventaire

GET /inventory — liste tous les SKUs avec quantités actuelles
GET /inventory/:sku — récupère un SKU
POST /inventory — crée un nouveau SKU
PATCH /inventory/:sku — met à jour les champs d'un SKU
DELETE /inventory/:sku — archive un SKU

Emplacements

GET /locations — liste entrepôts, allées, étagères, bacs
POST /locations — crée un nouvel emplacement
POST /locations/:id/transfer — transfère du stock entre emplacements

Commandes

GET /orders — liste les commandes, filtrées par statut
POST /orders — crée une commande (depuis un système externe)
POST /orders/:id/pack — marque comme préparée
POST /orders/:id/ship — marque comme expédiée, décrémente l'inventaire

Scans

POST /scans — enregistre un événement de scan (avancé)
GET /scans — historique paginé des scans

Requête d'exemple

curl https://api.klovio.app/v1/inventory \
  -H "Authorization: Bearer klv_live_********************" \
  -H "Content-Type: application/json" \
  -d '{
    "sku": "OOL-001-1L",
    "name": "Huile d\'olive bio 1L",
    "on_hand": 248,
    "reorder_point": 50,
    "location": "allee-a/etagere-3"
  }'

Webhooks

Abonnez-vous aux événements via Paramètres → Développeurs → Webhooks. Événements disponibles :

inventory.updated — déclenché à tout changement de quantité
inventory.low_stock — quand un SKU passe sous son seuil
order.created · order.packed · order.shipped
scan.completed — à chaque scan (volume élevé — filtrez avec soin)

Les payloads sont signés en HMAC-SHA256. Vérifiez le header Klovio-Signature contre votre secret webhook.

SDKs

Node.js : npm install @klovio/node
Python : pip install klovio
Ruby : gem install klovio
Go : go get github.com/klovio/go-sdk

API REST Klovio.