Aller au contenu
LinkProfit

Présentation de l’API

API REST v1 pour les liens, les statistiques, les domaines et les opérations partenaires : URL de base, types de clés, portées et modèle en marque blanche.

Mis à jour le 13 août 2026

Tout ce que fait le tableau de bord, l’API le fait aussi : créer des liens avec ciblage et répartitions A/B, lire les statistiques, connecter des domaines, gérer les clients et les forfaits. L’API est une surface produit de premier plan — le tableau de bord et l’API exécutent le même code et appliquent les mêmes limites.

URL de base

https://api.linkprofit.com/v1

Toutes les requêtes utilisent HTTPS et JSON. Les réponses sont en JSON, à l’exception de l’image QR et de l’export CSV. La référence interactive, toujours à jour, se trouve sur /docs/api/reference ; elle est générée à partir des schémas mêmes qui valident chaque requête.

Deux types de clés

| Préfixe de clé | Portée | Créée dans | Ouvre | |---|---|---|---| | lp_live_… | Espace de travail | Réglages de l’espace de travail → Clés API | /links, /analytics, /domains, /workspace, /events, /webhooks | | lpp_live_… | Partenaire | Réglages partenaire → Clés API | /partner/* et /webhooks |

Une clé d’espace de travail agit dans un seul espace de travail client. Une clé partenaire gère le compte partenaire : clients, forfaits, domaines, paiements. Les clés portent des portées qui limitent ce que chacune peut faire.

Versionnement

La v1 est gelée : les champs sont uniquement ajoutés, jamais renommés ni supprimés. Les changements incompatibles arriveraient dans /v2. Développez contre les champs documentés et ignorez ceux que vous ne connaissez pas.

Marque blanche : proposer l’API à vos clients

Si vous exploitez un service de liens en marque blanche, l’API fait partie de ce que vous revendez :

  • Les clés sont à vous de distribuer. Chaque client crée ses clés d’espace de travail dans son propre tableau de bord de marque (Réglages → Clés API) — vous ne partagez jamais votre clé partenaire.
  • L’hôte reste partagé. En v1, tout le trafic API va vers api.linkprofit.com — un domaine d’API personnalisé par partenaire n’est pas encore disponible. Documentez l’URL de base comme « l’hôte d’API de votre service » ; les réponses ne portent aucune marque LinkProfit.
  • Les limites suivent vos forfaits. L’accès à l’API est un interrupteur des forfaits que vous vendez (api_access), et la limite de débit de chaque clé vient du forfait. Un client sur un forfait sans accès à l’API reçoit 403 plan_restricted.

Voir le guide marque blanche pour une page prête à copier que vous pouvez adapter à votre propre documentation développeur.

Repères rapides