L'API GetAff

Ce que vous pouvez en faire

La version 1 expose quatre lectures. Elle ne permet aucune écriture : ni soumission de programme, ni modification de compte. C'est délibéré — une API en lecture seule n'a pas de mode de défaillance destructeur, et nous préférons publier un contrat étroit que nous tiendrons plutôt qu'un contrat large que nous reprendrions.

• Parcourir le répertoire public des programmes, filtré et paginé.
• Lire une fiche programme précise à partir de son identifiant.
• Connaître votre plan, vos capacités et vos plateformes connectées.
• Récupérer vos commissions, filtrées par date, réseau et statut.

En trois étapes

1. Connectez-vous, puis créez une clé depuis la page « Clés d’API ». Elle ne sera affichée qu’une seule fois.
2. Conservez-la côté serveur, dans un gestionnaire de secrets ou une variable d’environnement.
3. Envoyez-la sur chaque appel, dans l’en-tête Authorization.

Premier appel

Aucun en-tête supplémentaire n'est nécessaire. Les réponses sont toujours du JSON encodé en UTF-8.

curl -s 'https://getaff.org/api/v1/programs?vertical=saas&minScore=60&limit=2' \
  -H 'Authorization: Bearer gaff_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

Réponse

{
  "data": [
    {
      "slug": "northstack-northstack",
      "name": "NorthStack",
      "host": "northstack.io",
      "site": "https://northstack.io",
      "pitch": "Managed Postgres for teams that ship on Fridays. Free tier, usage billing.",
      "vertical": "saas",
      "model": "recurring",
      "commission": "25% recurring",
      "recurring": true,
      "cookieDays": 90,
      "payout": "monthly",
      "minPayout": 50,
      "markets": [
        "FR",
        "BE",
        "CH",
        "DE"
      ],
      "platform": "in-house",
      "signupUrl": "https://northstack.io/partners",
      "score": 78,
      "image": "",
      "createdAt": "2026-03-11T09:24:00.000Z"
    }
  ],
  "page": {
    "limit": 2,
    "hasMore": true,
    "nextCursor": "Wzc4LCJ2SzlxIl0"
  }
}

Pagination

Les collections se paginent par curseur, jamais par décalage. Reprenez page.nextCursor tel quel dans le paramètre cursor. Le curseur est opaque : son contenu peut changer sans préavis, sa signification non.

Versionnement

La version fait partie du chemin. Tant que /v1 existe, aucun champ n'en disparaîtra et aucun champ obligatoire ne s'y ajoutera : nous pouvons ajouter des champs facultatifs, jamais en retirer. Une rupture donnerait /v2, servie en parallèle. Écrivez donc des clients qui ignorent les champs qu'ils ne connaissent pas.

Spécification lisible par machine

Le document OpenAPI 3.1 est dérivé des mêmes schémas que ceux appliqués par les routes : il ne peut pas décrire autre chose que ce qui est réellement validé. Utilisez-le pour générer un client.