L'API RefCampaign couvre tout ce que vous pouvez faire depuis le tableau de bord — et quelques opérations qui ne s'y trouvent pas, comme le suivi des conversions de serveur à serveur et les opérations en lot sur les commissions.

Les endpoints sont versionnés sous `/api/v1/*` et authentifiés par JWT Bearer émis depuis le tableau de bord. Les réponses suivent une enveloppe cohérente, les erreurs renvoient des codes machine-readable, et la spec est publiée en OpenAPI 3.1.

## Par où commencer

* **[Démarrage](/fr/docs/api/getting-started)** — inscription, génération d'une clé API, première requête.
* **[Authentification](/fr/docs/api/authentication)** — fonctionnement des clés API, format du header, rotation.
* **[Intégration / SDK](/fr/docs/api/integration/sdk)** — installation du paquet officiel `@refcampaign/sdk` dans une app JS / TS.
* **[Intégration / postback S2S](/fr/docs/api/integration/postback)** — suivi des conversions directement depuis votre backend, sans SDK.
* **[Gestion des erreurs](/fr/docs/api/error-handling)** — enveloppe d'erreur, codes, retries.
* **[Référence API](/fr/docs/api/reference)** — auto-générée, chaque endpoint avec try-it-out.

## Stabilité et versioning

La version actuelle est `v1`. Tous les endpoints publics vivent sous `/api/v1/*`. Les changements breaking sont introduits derrière un nouveau préfixe de version ; `v1` continue de recevoir les ajouts non-breaking. Les dépréciations sont annoncées par un header HTTP `Deprecation` au moins 90 jours avant la suppression.

## Besoin d'aide ?

Ouvrez une issue sur le [repo SDK](https://github.com/RefCampaign/sdk) ou contactez-nous depuis le tableau de bord.