Aperçu de l'API

L’API storekit vous permet de gérer par programmation vos magasins, vos menus et vos commandes.

Early Access - L’API storekit est actuellement en early access et n’est pas largement disponible. L’accès est accordé au cas par cas : demandez-le via le formulaire storekit MCP/API Access Request, en précisant ce que vous développez, les magasins ou le compte concernés, les données ou actions dont vous avez besoin, et votre volume prévu. Voir Demander l’accès à l’API.

Authentification

Toutes les requêtes API nécessitent une authentification via une clé API. Incluez votre clé API dans l’en-tête x-api-key :

curl -X POST https://api.storekit.com/pos/availability \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

Les clés API sont délivrées par l’équipe storekit lors de l’onboarding. Chaque clé API est limitée à un compte spécifique et ne peut accéder qu’aux ressources de ce compte.

URL de base

Toutes les requêtes API doivent être adressées à :

https://api.storekit.com

Endpoints disponibles

Endpoint	Méthode	Description
/pos/availability	POST	Mettre à jour la disponibilité et l’inventaire des articles

Gestion des erreurs

L’API utilise les codes de statut HTTP standards :

Statut	Description
200	Succès
400	Requête invalide — vérifiez votre payload
401	Non autorisé — clé API invalide ou manquante
404	Introuvable — magasin ou ressource non trouvé
500	Erreur serveur

Les réponses d’erreur incluent un message expliquant ce qui n’a pas fonctionné :

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "No active menu found for this venue"
}

⌘I

​Authentification

​URL de base

​Endpoints disponibles

​Gestion des erreurs

Authentification

URL de base

Endpoints disponibles

Gestion des erreurs