API RefCampaign
API REST pour le suivi des affiliés, l'attribution des conversions et les paiements.
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 — inscription, génération d'une clé API, première requête.
- Authentification — fonctionnement des clés API, format du header, rotation.
- Intégration / SDK — installation du paquet officiel
@refcampaign/sdkdans une app JS / TS. - Intégration / postback S2S — suivi des conversions directement depuis votre backend, sans SDK.
- Gestion des erreurs — enveloppe d'erreur, codes, retries.
- Référence API — 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 ou contactez-nous depuis le tableau de bord.