Guide d'intégration de la Fansly API : configuration, webhooks et endpoints

Si vous développez un outil Fansly (CRM, automatisation, tableau de bord ou plateforme d'agence complète), la Fansly API vous donne un accès authentifié à plus de 80 endpoints en production, avec des webhooks en temps réel. Ce guide passe en revue tout ce qu'il faut pour livrer une intégration en production : création du compte, gestion des webhooks, budget de crédits, accès d'équipe et supervision opérationnelle.

Ce qu'il vous faut avant d'intégrer la Fansly API

Toute intégration de la Fansly API nécessite trois éléments :

1. Un compte Fansly API : inscrivez-vous gratuitement sur fansly-api.com/register. L'offre gratuite inclut 100 crédits de bienvenue pour tester n'importe quel endpoint.
2. Une clé API : générée dans le tableau de bord, propre à chaque membre de l'équipe et renouvelable à la demande.
3. Un compte créateur Fansly à connecter : nécessaire pour les appels authentifiés qui lisent ou écrivent des données côté créateur.

Une fois ces trois éléments réunis, vous êtes prêt à faire votre premier appel.

Comment fonctionnent les webhooks Fansly

Les webhooks sont l'alternative au polling digne d'un environnement de production. Chaque événement sur Fansly (nouveau message, vente, renouvellement, abonnement, pourboire, réaction dans un chat) déclenche un webhook vers l'endpoint que vous enregistrez dans le tableau de bord.

Chaque livraison de webhook comprend :

• Une signature HMAC-SHA256 dans l'en-tête X-Fansly-Signature
• Le type d'événement (message.received, sale.completed, subscription.renewed, subscription.expired, tip.received, chat.reaction, etc.)
• La charge utile avec toutes les données de l'événement
• Une clé d'idempotence pour dédupliquer les nouvelles tentatives

Vérifiez la signature avant de faire quoi que ce soit avec la charge utile :

import { createHmac } from 'crypto'
 
function verifyWebhook(body, signature, secret) {
  const expected = createHmac('sha256', secret)
    .update(body)
    .digest('hex')
  return signature === expected
}

Dédupliquez ensuite sur la clé d'idempotence pour que les nouvelles tentatives soient sans risque :

const seen = new Set()
 
function handleWebhook(event) {
  if (seen.has(event.idempotencyKey)) return
  seen.add(event.idempotencyKey)
  // traiter l'événement
}

Les webhooks sont facturés 1 crédit pour 100 événements livrés. Les livraisons échouées sont relancées avec un backoff exponentiel et apparaissent sur la page Webhook Logs du tableau de bord.

Cas d'usage courants des webhooks

• Synchronisation d'un chatbot : abonnez-vous à message.received, lancez l'inférence IA et envoyez la réponse via l'endpoint de messagerie
• Alertes whales : abonnez-vous à tip.received et déclenchez une alerte Slack/Telegram quand le montant dépasse un seuil
• Mises à jour du CRM : abonnez-vous à subscription.renewed et subscription.expired et synchronisez le statut des fans avec votre CRM
• Tableaux de bord de revenus : abonnez-vous à sale.completed et écrivez dans votre entrepôt de données pour un reporting en temps réel

Référence des endpoints de la Fansly API

La Fansly API expose plus de 80 endpoints répartis en neuf catégories d'objets. Les principales catégories que vous intégrerez en premier :

• Comptes : lister les comptes connectés, rafraîchir les tokens, gérer les sessions
• Fans et abonnements : lister les fans, obtenir les indicateurs d'abonnés, filtrer par statut
• Chats et messages : envoyer des messages, gérer les chats, activer/désactiver la sourdine, épingler/désépingler, aimer/ne plus aimer, galerie, fils de réponses
• Revenus et versements : planification des versements quotidiens, ventilation des revenus, suivi des rétrofacturations (chargebacks)
• Posts et médias : créer des posts, téléverser des médias dans le coffre-fort, gérer la récupération de médias avec des URL qui peuvent ne jamais expirer
• Stories : lister, créer et analyser les Stories et les Story Highlights Fansly
• Listes d'utilisateurs : créer, mettre à jour, ajouter ou retirer des utilisateurs pour une messagerie segmentée
• Statistiques : indicateurs généraux sur les fans, les visiteurs et les posts, avec filtrage par période
• Liens de tracking : générer des URL d'essai et de tracking pour vos campagnes

La référence complète des endpoints est disponible après l'inscription, dans le playground du tableau de bord.

Tarifs et crédits expliqués

Les crédits sont l'unité d'usage de la Fansly API. Chaque appel, webhook ou téléchargement de média consomme un nombre de crédits connu.

• Offre gratuite : 100 crédits de bienvenue pour tester n'importe quel endpoint
• Basic : $69/mois, 20 000 crédits + 1 000 RPM, 1 compte
• Pro : $299/mois, 100 000 crédits + 10 000 par compte supplémentaire + 5 000 RPM, 5 comptes
• Enterprise : plus de 100 comptes avec développement sur mesure, tarif par compte à partir de $10

Les événements webhook sont facturés 1 crédit pour 100 événements. Le tableau Credits de la page Usage détaille la consommation par fonctionnalité : vous savez toujours où partent vos crédits.

Consultez la page des tarifs complète pour comparer les offres.

Questions fréquentes sur l'intégration de la Fansly API

Combien de temps prend l'intégration de la Fansly API ? La plupart des équipes ont une intégration fonctionnelle en production en moins d'une heure : création du compte, génération de la clé API, premier appel authentifié et configuration des abonnements aux webhooks.

À quoi ressemble la signature des webhooks Fansly ? Chaque webhook est signé en HMAC-SHA256. Vérifiez l'en-tête de signature avec votre secret partagé avant de traiter la charge utile. Rejetez toute requête dont la vérification échoue.

Comment surveiller les erreurs de la Fansly API en production ? La page Logs du tableau de bord affiche chaque requête, réponse et erreur en temps réel. Une page de statut publique suit la disponibilité et les incidents de tous les endpoints.

Plusieurs développeurs peuvent-ils travailler sur le même compte Fansly API ? Oui. La gestion d'équipe vous permet d'inviter des développeurs avec un accès basé sur les rôles. Aucun partage de mot de passe : chaque membre de l'équipe a ses propres identifiants et son propre journal d'audit.

Que se passe-t-il si la livraison d'un webhook Fansly échoue ? Les livraisons échouées sont relancées automatiquement avec un backoff exponentiel. Chaque nouvelle tentative porte la même clé d'idempotence, pour que votre endpoint puisse dédupliquer sans risque. La page Webhook Logs affiche chaque tentative et son statut final.

Ce qui a changé avec la version d'octobre 2025

Ce guide tient compte de la grande mise à jour de la Fansly API d'octobre 2025, qui a introduit :

• Des webhooks 100 fois moins chers : le tarif est passé de 1 crédit par événement à 1 crédit pour 100 événements
• Un chatbot IA dans la documentation et le tableau de bord : une aide contextuelle sans quitter votre workflow
• Des versements quotidiens via l'endpoint de fréquence de paiement : des versements automatiques aux créateurs
• Les invitations d'équipe et l'accès basé sur les rôles : des comptes Fansly API à plusieurs développeurs
• Une vue d'ensemble complète des logs : chaque requête, réponse et erreur dans la barre latérale
• Plus de 22 nouveaux endpoints : User Lists, Subscriber Metrics, Statistics Overview, Latest Fans, Chargebacks, Chat Media Gallery, indicateur de saisie, commandes Pin/Mute/Like sur les messages, prise en charge des réponses à un message et nouveaux filtres pour List Chats

Suivez @onlyfansapi_updates sur Telegram pour les dernières nouveautés.

Prêt à intégrer ? Inscrivez-vous gratuitement : 100 premiers crédits inclus, sans carte bancaire.

Des questions ? Contactez-nous par e-mail ou sur Telegram.