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

# Journal des modifications

> Les évolutions de l'API publique et des Pulses.

Les changements qui peuvent affecter votre intégration sont annoncés ici. Les ajouts rétrocompatibles (nouveaux champs, nouveaux endpoints, nouveaux événements) n'incrémentent pas la version : `/v1` reste stable.

## Octobre 2026

### Validation de licence, affiliés et API Pulses

* **Nouveau** `POST /v1/licenses/validate` : valide une clé en un appel, sans rien modifier. Répond toujours `200` ; lisez `valid` et `reason`.
* **Nouveau** `GET /v1/licenses/{clé}` et les actions d'activation acceptent désormais la clé de licence à la place de l'identifiant.
* **Nouveau** permission `affiliates.read` et endpoints `GET /v1/affiliates`, `GET /v1/affiliates/{id}` (identifiant ou code) et `GET /v1/affiliates/{id}/commissions`. Lecture seule ; l'e-mail et le solde de l'affilié ne sont jamais exposés.
* **Nouveau** gestion complète des Pulses par l'API (`pulses.read`, `pulses.write`) : création, modification, test, changement de secret, historique d'envoi.
* **Nouveau** spécification OpenAPI enrichie : exemples de code et description des événements Pulses (`webhooks`).
* **Retiré** la création de webhooks hérités (`POST /integrations/webhooks`) répond maintenant `410 legacy_webhooks_retired`. Utilisez les [Pulses](https://docs.pulse-sell.com/pulses/overview.md). Les anciens webhooks existants restent lisibles le temps de votre migration.

### Pulses v2

* 12 événements signés, plus le joker `*`.
* Signature `X-PulseSell-Signature` (`t=…,v1=…`, HMAC-SHA256) avec tolérance de 5 minutes.
* Relances à 1 min, 5 min, 30 min et 2 h ; désactivation automatique après 5 échecs consécutifs, avec alerte par e-mail.
* Les anciennes clés d'API sont retirées : utilisez les clés `psk_…`.

### API publique v1

* Clés `psk_…` par boutique, avec permissions, expiration et liste d'adresses IP autorisées.
* Produits, checkout, ventes, clients, codes promo et licences.
* Pagination par curseur, `Idempotency-Key`, limite de 100 requêtes par minute et par clé.

## À venir

Ces éléments ne sont **pas** encore disponibles :

* invitation d'affiliés par l'API ;
* remboursement par l'API ;
* équipe et collaborateurs, transfert de propriété d'une boutique.


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