> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/fr/developers/api/quickstart.md).

# Démarrage rapide

> Générez un jeton d’API et envoyez votre première requête à l’API BoxHero.

Ce guide vous accompagne de l’absence de jeton jusqu’à votre premier appel d’API réussi.

## 1. Générer un jeton d’API

Dans l’application web sur ordinateur, ouvrez l’équipe que vous souhaitez connecter et allez dans `Paramètres` > `Intégrations et API`. Générez un nouveau jeton d’API et copiez-le.

![](https://assets.boxhero.io/docs/images/e6bbc8fa4eab21ec0f9ebe74893cd3a6e0c6a5d4d178ae02478ef99adbe4c4cd-2214x1431.jpg)

> **Caution**
>
> **Remarque** : un jeton est lié à l’équipe dans laquelle il a été généré et donne un accès complet aux données de cette équipe via l’API. Conservez-le sur votre serveur — ne le placez jamais dans une application mobile, du code exécuté dans le navigateur ou un dépôt public.

## 2. Envoyer votre première requête

Appelez [Get the linked team](https://www.boxhero.io/docs/fr/developers/api/reference/teams/get-linked-team) pour vérifier que le jeton fonctionne. Envoyez le jeton dans l’en-tête `Authorization` :

```bash
curl https://rest.boxhero-app.com/v1/teams/linked \
  -H "Authorization: Bearer $BOXHERO_API_TOKEN"
```

La réponse décrit l’équipe à laquelle appartient le jeton :

```json
{
  "id": 149058,
  "name": "Acme Retail",
  "mode": 2,
  "currency_symbol": "$",
  "currency_code": "USD",
  "price_decimal_places": 2,
  "memo": null
}
```

Si vous obtenez plutôt une erreur `401`, le jeton est absent ou a été copié de manière incomplète. Consultez [Erreurs](https://www.boxhero.io/docs/fr/developers/api/errors) pour le format des erreurs.

> **Note**
>
> La plupart des endpoints ne fonctionnent que pour les équipes qui gèrent leur stock par [site](https://www.boxhero.io/docs/fr/concepts/locations). Pour les autres équipes, ils renvoient une erreur de type `/errors/invalid-team-mode`. Pour une équipe par site, `mode` vaut `2` dans la réponse ci-dessus.

## 3. Étapes suivantes

- Listez votre stock avec [List items](https://www.boxhero.io/docs/fr/developers/api/reference/items/list-items), et découvrez comment récupérer toutes les pages dans [Pagination](https://www.boxhero.io/docs/fr/developers/api/pagination).
- Enregistrez les mouvements de stock avec [Create a transaction](https://www.boxhero.io/docs/fr/developers/api/reference/transactions/create-transaction) — consultez [Transactions](https://www.boxhero.io/docs/fr/developers/api/reference/transactions) pour les règles.
- Soyez averti des changements au lieu d’interroger l’API en boucle grâce aux [webhooks](https://www.boxhero.io/docs/fr/developers/webhooks/overview).
- Parcourez tous les endpoints dans la [référence de l’API](https://www.boxhero.io/docs/fr/developers/api/reference).