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

# Postman

> Testez l'API Bonx depuis Postman en quelques clics.

L'API Bonx fournit un schéma **OpenAPI** : Postman peut le transformer en
collection prête à l'emploi, avec tous les endpoints et leurs paramètres.

<Steps>
  <Step title="Importez la spec OpenAPI">
    Dans Postman : **Import** → collez l'URL de la spec de votre espace (ou
    déposez le fichier `openapi.json`). Postman génère une collection avec les
    endpoints (Commandes de vente, etc.).
  </Step>

  <Step title="Créez un environnement">
    Ajoutez deux variables :

    | Variable | Valeur |
    | - | - |
    | `baseUrl` | votre URL d'API (Paramètres → Tokens d'API) |
    | `apiKey` | votre jeton d'API (`bxk_live_...`) |
  </Step>

  <Step title="Ajoutez l'en-tête d'authentification">
    Au niveau de la collection, ajoutez un en-tête appliqué à toutes les
    requêtes :

    ```
    x-api-key: {{apiKey}}
    ```
  </Step>

  <Step title="Envoyez une requête">
    Sélectionnez **Lister les commandes de vente**, vérifiez que l'URL utilise
    `{{baseUrl}}`, puis **Send**.
  </Step>
</Steps>

<Tip>Réimportez la spec à chaque nouvelle version de l'API pour récupérer automatiquement les nouveaux endpoints.</Tip>