Proposer l’API à vos clients

Vos clients peuvent automatiser leurs liens comme vous automatisez votre compte partenaire. Cette page est le mode d’emploi pour faire de l’API une fonctionnalité de votre produit — y compris le texte que vous pouvez adapter pour votre propre documentation développeur.

Comment cela fonctionne

• Les clients créent leurs propres clés. Chaque espace de travail sur un forfait avec accès à l’API dispose de Réglages → Clés API dans le tableau de bord à votre marque. Les clés appartiennent à l’espace de travail : votre clé partenaire n’est jamais impliquée, et un client ne peut atteindre que ses propres données.
• L’hôte est partagé. Toutes les requêtes vont vers https://api.linkprofit.com/v1. En v1, un domaine d’API personnalisé par partenaire n’est pas disponible — documentez l’hôte comme le point d’entrée technique de votre service. Les réponses ne portent aucune marque LinkProfit : domaines, liens et statistiques des charges utiles appartiennent à votre client.
• Vous décidez qui y a droit. L’accès à l’API est l’interrupteur api_access des forfaits que vous vendez. Les clients sur un forfait sans cet interrupteur reçoivent 403 plan_restricted — un moment de montée en gamme bien net. Les limites de débit suivent la clé : un forfait plus lourd peut donc être livré avec une limite plus élevée.

Ce qu’il faut mettre dans votre documentation

Une page développeur minimale pour vos clients tient en quatre points :

1. Où vivent les clés — « Réglages → Clés API dans votre tableau de bord ; la clé n’est affichée qu’une fois ».
2. L’URL de base — https://api.linkprofit.com/v1, authentification avec Authorization: Bearer <clé>.
3. Un démarrage rapide — copiez le Démarrage rapide et remplacez le domaine d’exemple par l’un des vôtres.
4. La référence — pointez vers la référence interactive ou hébergez le fichier OpenAPI (https://linkprofit.com/openapi.json) dans votre propre outil de documentation ; il s’affiche tel quel dans Scalar, Swagger UI, Redoc et Postman.

Les webhooks pour vos clients

Les espaces de travail clients enregistrent leurs propres endpoints de webhooks pour les événements de liens, de domaines et de seuils de clics. Les événements de niveau partenaire — abonnements, paiements — restent sur vos endpoints partenaires et ne sont jamais livrés aux clients.

Des limites qui méritent d’être mentionnées

• Les clés sont par espace de travail : un client-agence qui gère plusieurs espaces de travail crée une clé dans chacun.
• Le journal d’audit attribue les changements d’API à la clé, visible par le client dans son tableau de bord — les échanges avec le support commencent par des faits.
• Tout ce que l’API écrit obéit aux mêmes quotas de forfait que le tableau de bord : un client ne peut pas contourner par script la limite de liens que vous lui avez vendue.