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

# Permissions

> Le catalogue des permissions d'une clé et comment accorder le strict nécessaire.

Une clé n'a que les permissions que vous lui donnez. Chaque endpoint en exige une seule, indiquée dans la [référence](https://docs.pulse-sell.com/api-reference/introduction). Sans elle, la réponse est `403 missing_scope` et le champ `errors.scopes` nomme la permission manquante.

> [!NOTE]
>
> Une permission `.write` inclut automatiquement la lecture correspondante : `products.write` permet aussi de lister les produits. L'inverse n'est jamais vrai.

| Permission | Ce qu'elle permet |
| - | - |
| `store.read` | Lire le nom, le logo et l'adresse de la boutique liée. |
| `products.read` | Lister et consulter les produits. |
| `products.write` | Créer, modifier, publier, dépublier, archiver et supprimer des produits. |
| `sales.read` | Lister et consulter les commandes. |
| `sales.write` | Marquer une commande livrée ou annuler une commande impayée. |
| `customers.read` | Lister et consulter les clients (acheteurs). |
| `discounts.read` | Lister et consulter les codes promo. |
| `discounts.write` | Créer, modifier et supprimer des codes promo. |
| `licenses.read` | Lister et consulter les licences, valider une clé, lire les activations. |
| `licenses.write` | Activer, désactiver et révoquer des licences. |
| `affiliates.read` | Lister les affiliés, vérifier un code de parrainage, lire les commissions. |
| `pulses.read` | Lister les Pulses et leur historique d'envoi. |
| `pulses.write` | Créer, modifier, supprimer et tester des Pulses. |
| `checkout.write` | Créer un lien de paiement pour un produit. |

## Recommandations

> **Une clé par usage**
>
> Une clé pour votre serveur de licences, une autre pour Zapier. Si l'une fuit, vous ne révoquez que celle-là.

> **Lecture seule par défaut**
>
> Un tableau de bord ou un export n'a besoin que des permissions `.read`.

> **Valider une licence, rien de plus**
>
> `POST /licenses/validate` ne demande que `licenses.read` : votre logiciel peut vérifier une clé sans pouvoir en révoquer.

> **Aucun remboursement par API**
>
> Le remboursement est un mouvement d'argent : il reste dans le tableau de bord, quelle que soit la clé.


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