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

# Présentation de la référence

> Adresse de base, authentification, conventions et liste de tous les endpoints.

Adresse de base :

```text theme={null}
https://api.pulse-sell.com/v1
```

Toutes les requêtes envoient `Authorization: Bearer psk_…` et, pour un corps, `Content-Type: application/json`. Voir [Authentification](https://docs.pulse-sell.com/authentication.md).

> [card] [Réponses](https://docs.pulse-sell.com/concepts/responses.md)
>
> Enveloppe `data`, montants, dates.

> [card] [Pagination](https://docs.pulse-sell.com/concepts/pagination.md)
>
> Curseurs, `per_page` jusqu'à 100.

> [card] [Erreurs](https://docs.pulse-sell.com/concepts/errors.md)
>
> Codes stables à traiter dans votre code.

## Tous les endpoints

| Ressource | Endpoints | Permission |
| - | - | - |
| [Compte](https://docs.pulse-sell.com/api-reference/compte.md) | `GET /me` | aucune |
| [Boutique](https://docs.pulse-sell.com/api-reference/compte.md) | `GET /store` | `store.read` |
| [Produits](https://docs.pulse-sell.com/api-reference/produits.md) | `GET /products`, `GET /products/{id}`, `POST /products`, `PATCH /products/{id}`, `POST /products/{id}/publish`, `POST /products/{id}/unpublish`, `POST /products/{id}/archive`, `DELETE /products/{id}` | `products.read` / `products.write` |
| [Checkout](https://docs.pulse-sell.com/api-reference/checkout.md) | `POST /checkout` | `checkout.write` |
| [Ventes](https://docs.pulse-sell.com/api-reference/ventes.md) | `GET /sales`, `GET /sales/{id}`, `POST /sales/{id}/fulfill`, `POST /sales/{id}/cancel` | `sales.read` / `sales.write` |
| [Clients](https://docs.pulse-sell.com/api-reference/clients.md) | `GET /customers`, `GET /customers/{id}` | `customers.read` |
| [Codes promo](https://docs.pulse-sell.com/api-reference/remises.md) | `GET /discounts`, `GET /discounts/{id}`, `POST /discounts`, `PATCH /discounts/{id}`, `DELETE /discounts/{id}` | `discounts.read` / `discounts.write` |
| [Licences](https://docs.pulse-sell.com/api-reference/licences.md) | `POST /licenses/validate`, `GET /licenses`, `GET /licenses/{id}`, `GET /licenses/{id}/activations`, `POST /licenses/{id}/activate`, `POST /licenses/{id}/deactivate`, `POST /licenses/{id}/revoke` | `licenses.read` / `licenses.write` |
| [Affiliés](https://docs.pulse-sell.com/api-reference/affilies.md) | `GET /affiliates`, `GET /affiliates/{id}`, `GET /affiliates/{id}/commissions` | `affiliates.read` |
| [Pulses](https://docs.pulse-sell.com/api-reference/pulses.md) | `GET /pulses`, `GET /pulses/{id}`, `POST /pulses`, `PATCH /pulses/{id}`, `DELETE /pulses/{id}`, `POST /pulses/{id}/test`, `POST /pulses/{id}/rotate-secret`, `GET /pulses/{id}/deliveries` | `pulses.read` / `pulses.write` |

## Spécification OpenAPI

L'API publie sa propre spécification OpenAPI 3.1, générée depuis le code qui sert les requêtes : elle ne peut pas diverger de la réalité. Elle inclut les permissions de chaque endpoint, des exemples cURL, Node.js et Python, et les 12 événements Pulses.

```bash theme={null}
curl https://api.pulse-sell.com/v1/openapi.json
```

Importez-la dans Postman, Insomnia ou un générateur de client pour obtenir un SDK dans votre langage. Elle est publique : elle ne contient aucune donnée de compte.

## Ce que l'API ne fait pas, volontairement

* **Aucun remboursement** : mouvement d'argent, il reste dans le tableau de bord.
* **Aucune publication implicite** : un produit n'est jamais publié par un simple `POST` ou `PATCH`.
* **Aucune livraison sans paiement** : `fulfill` refuse une commande non encaissée.
* **Aucune donnée de carte** : le paiement se fait sur la page hébergée.


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