> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Aperçu de l'API

> Connectez votre application à l'API REST de storekit. Découvrez l'authentification, les URL de base et la gestion programmatique des magasins et des commandes.

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

> [!WARNING]
>
> **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](https://t09czsyu90l.typeform.com/to/G6rIJWNv), 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](/docs/fr/developers/introduction#requesting-api-access).

## 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` :

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

> [!NOTE]
>
> 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](/docs/fr/developers/api/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é :

```json theme={null}
{
  "statusCode": 404,
  "error": "Not Found",
  "message": "No active menu found for this venue"
}
```


## Related topics

- [API et webhooks](/docs/fr/guides/integrations/api-webhooks.md)
- [Aperçu des agents de commande](/docs/fr/developers/agents/ordering/overview.md)
- [Aperçu du menu](/docs/fr/guides/menu/overview.md)
- [Introduction pour les développeurs](/docs/fr/developers/introduction.md)
- [API e webhook](/docs/it/guides/integrations/api-webhooks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.