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

# Authentification

> Envoyez une clé d'API ou un jeton d'accès OAuth comme jeton de type Bearer à chaque appel.

Envoyez un jeton de type Bearer dans l'en-tête `Authorization` à chaque appel :

```http theme={null}
GET /api/v1/catalog/items HTTP/1.1
Host: app.stockshift.io
Authorization: Bearer 7|Zc1q...
Accept: application/json
```

Quelques points de terminaison, comme la connexion des applications mobiles, ne prennent pas de jeton, et leur entrée dans la référence de l'API le précise.

Il existe deux types de jetons. Une fois reçus, l'API les traite de la même façon.

| Jeton | Pour | Provenance |
| - | - | - |
| Clé d'API | Vos propres scripts et les intégrations de serveur à serveur | Un membre la crée dans l'application |
| Jeton d'accès OAuth | Les applications que d'autres personnes connectent à leur compte StockShift | Votre application exécute le [flux OAuth](https://docs.stockshift.io/fr-ca/guides/oauth-apps.md) |

## Clés d'API

**Paramètres > Accès > Clés d'API** liste les clés de l'organisation avec leur nom, leur propriétaire, leurs portées, leur date de création, leur date d'expiration et leur dernière utilisation.

Pour en créer une, appuyez sur **Nouvelle clé d'API**, donnez-lui un nom, choisissez une date d'expiration (ou aucune) et cochez les portées dont elle a besoin. Copiez la clé quand elle s'affiche, car elle ne sera plus jamais affichée. Les clés qui expirent sont plus sûres.

Une clé appartient au membre qui l'a créée et à l'organisation dans laquelle elle a été créée :

* Elle ne peut jamais faire plus que ce membre. Chaque appel exige à la fois l'autorisation du membre et l'une des portées de la clé. Consultez [Autorisations et portées](https://docs.stockshift.io/fr-ca/guides/permissions-and-scopes.md).
* Elle ne peut accéder à aucune autre organisation.
* Si le membre quitte l'organisation, la clé cesse de fonctionner.

Appuyez sur **Révoquer** pour arrêter une clé immédiatement. Tout ce qui l'utilise reçoit dès lors un `401`, et la clé reste dans la liste, marquée comme révoquée.

## Quand un jeton échoue

| Statut | `code` | Raison |
| - | - | - |
| `401` | `unauthenticated` | Aucun jeton, ou un jeton expiré ou révoqué. |
| `403` | `forbidden` | Le membre n'a pas l'autorisation ou le jeton n'a pas la portée. |

Gardez les clés hors du contrôle de version et du code côté client. Chargez-les depuis votre gestionnaire de secrets ou votre environnement, comme le font les exemples ici avec `STOCKSHIFT_TOKEN`.


## Related topics

- [.NET](https://docs.stockshift.io/fr-ca/sdks/dotnet.md)
- [Go](https://docs.stockshift.io/fr-ca/sdks/go.md)
- [PHP](https://docs.stockshift.io/fr-ca/sdks/php.md)


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