La référence est générée automatiquement depuis le spec OpenAPI 3.1 en direct sur
[`app.refcampaign.com/api/openapi.json`](https://app.refcampaign.com/api/openapi.json)
— pas de YAML manuel à maintenir, donc pas de dérive avec le code.

Les endpoints sont regroupés par tag dans la barre latérale :

* **Conversions** — suivre les conversions serveur-à-serveur, rembourser les conversions postback, lister et résumer les conversions.
* **Campaigns** — lister les campagnes et récupérer le détail d'une campagne.
* **Affiliates** — lister les affiliés et récupérer le détail d'un affilié.
* **Assets** — lister les assets marchands finalisés, créer des swipe copy, mettre à jour les métadonnées, archiver.
* **Commissions** — lister, approuver/rejeter en masse.
* **Applications** — accepter ou rejeter les candidatures d'affiliés, à l'unité ou en masse.
* **Dashboard** — récupérer les KPI marchands.
* **Payouts** — lister, créer, approuver, rejeter et marquer les paiements comme payés.
* **System** — valider une clé d'intégration avec l'endpoint ping.

Chaque page d'opération inclut :

* Le schéma complet de la requête (path params, query params, body JSON) avec marqueurs requis/optionnels.
* Un tableau de réponse par code de statut avec la forme du body JSON.
* Des exemples de code en cURL, JavaScript (`fetch`) et Python (`requests`).
* Un playground try-it-out qui passe la requête par le
  [proxy de transfert](https://docs.refcampaign.com/api/proxy) de ce site,
  pour que les règles CORS du navigateur ne bloquent pas la réponse.

<Callout type="info" title="Référence en anglais uniquement">
  Le contenu généré (descriptions de schémas, noms de champs) reste en anglais —
  c'est le langage de l'API elle-même. La navigation, la barre latérale et la
  recherche sont traduites.
</Callout>

## Authentification

Toutes les requêtes s'authentifient avec un token Bearer. Générez-en un dans le
tableau de bord sous **Paramètres → Clés API** et passez-le sur chaque requête :

```http
Authorization: Bearer <VOTRE_TOKEN>
```

Le playground expose un champ Authorization en haut de chaque opération —
collez le token pour tester l'endpoint en direct contre
`app.refcampaign.com`.

## Erreurs

Toute erreur renvoie une forme JSON cohérente :

```json
{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "currency must be a 3-letter ISO 4217 code",
    "details": { "field": "currency" }
  }
}
```

Voir [gestion des erreurs](/fr/docs/api/error-handling) pour la référence complète des codes.