> ## 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.

# Autorisations et portées

> Deux vérifications s'appliquent à chaque appel : l'autorisation du membre et la portée du jeton.

Deux vérifications s'appliquent à chaque appel, et les deux doivent réussir :

1. Le membre derrière le jeton doit avoir l'**autorisation**, comme `catalog.items.create`. Les autorisations viennent du rôle du membre dans l'organisation.
2. Le jeton doit avoir la **portée**, comme `catalog:write`. Les portées sont choisies quand la clé est créée ou quand un membre approuve une application OAuth.

Une clé avec `catalog:write` ne peut toujours pas créer d'articles si le rôle de son propriétaire ne le permet pas, et la clé d'un propriétaire limitée à `inventory:read` ne peut pas comptabiliser d'ajustements. Dans les deux cas, la réponse est un `403` avec le code `forbidden`. Chaque point de terminaison de la référence de l'API indique l'autorisation et la portée qu'il exige.

## Portées

Les portées vont par paires, lecture et écriture, pour chaque section de l'application. La lecture couvre tout ce qui ne fait que consulter. L'écriture couvre tout ce qui change quelque chose. Une clé d'API peut aussi détenir `*`, qui regroupe toutes les portées; une application OAuth ne le peut pas.

| Section | Portées |
| - | - |
| Accès | `access:read` |
| Historique d'audit | `audit:read` |
| Adresses | `address:read`, `address:write` |
| Automatisation | `automation:read`, `automation:write` |
| Facturation | `billing:read` |
| Catalogue | `catalog:read`, `catalog:write` |
| Tableau de bord | `dashboard:read`, `dashboard:write` |
| Développeurs | `developer:read`, `developer:write` |
| Appareils | `devices:read`, `devices:write` |
| Documents | `documents:read`, `documents:write` |
| Ingénierie | `engineering:read`, `engineering:write` |
| Analyses | `insights:read`, `insights:write` |
| Intégrations | `integrations:read`, `integrations:write` |
| Inventaire | `inventory:read`, `inventory:write` |
| Étiquettes | `labels:read`, `labels:write` |
| Bibliothèque de produits | `library:read` |
| Fabrication | `manufacturing:read`, `manufacturing:write` |
| Notifications | `notifications:read`, `notifications:write` |
| Organisation | `organization:read`, `organization:write` |
| Planification | `planning:read`, `planning:write` |
| Achats | `purchasing:read`, `purchasing:write` |
| Qualité | `quality:read`, `quality:write` |
| Ventes | `sales:read`, `sales:write` |
| Synchronisation | `sync:read`, `sync:write` |

Ne donnez à une clé que les portées dont sa tâche a besoin. Une clé qui alimente un tableau de bord des stocks n'a besoin que de `inventory:read`.

## Limites du forfait

Certaines fonctionnalités dépendent du forfait de l'organisation. Un appel à une fonctionnalité que le forfait n'inclut pas donne une réponse `403` avec le code `plan_upgrade_required`, et `feature` nomme ce qui manque. Rien n'est enregistré.


## Related topics

- [Authentification](https://docs.stockshift.io/fr-ca/guides/authentication.md)
- [Démarrage rapide](https://docs.stockshift.io/fr-ca/quickstart.md)
- [Référence de l'API](https://docs.stockshift.io/fr-ca/api-reference/introduction.md)


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