Outils développeur mym
Des outils développeur mym pensés pour l'intégration CRM mym.
Les outils développeur mym relient l'activité créateur à un CRM, un entrepôt de données ou votre propre produit, avec des clés à portée limitée et des webhooks signés.
GET /v1/creators/cr_1042/subscribers
{
"data": [
{ "id": "sub_5512", "fan_id": "fan_88213", "status": "active", "plan": "monthly" }
],
"next_cursor": "eyJpZCI6InN1Yl81NTk5In0",
"has_more": true
}Quels outils développeur sont inclus ?
Les briques sur lesquelles repose toute intégration CRM mym.
Clés d'API et portées
Des clés au niveau projet, à portée limitée à des créateurs et des données précises, pour qu'une clé n'accède qu'au nécessaire.
Connexions de compte
Un parcours de connexion contrôlé par le créateur, qui relie un compte mym à votre espace de travail sans collecter de mot de passe.
Profils créateurs
Des enregistrements de profil structurés : formules, champs de bio et paramètres publics pour chaque créateur connecté.
Fans et abonnés
Des listes d'abonnés avec formule, statut, date de renouvellement et valeur vie client pour la synchronisation CRM.
Conversations
Les métadonnées des conversations privées et le nombre de messages, utiles pour une boîte de réception d'équipe.
Workflows Private Media et MOD
Suivez les demandes de Private Media et de Media on Demand, de la création à l'achat par le fan.
Activité PPV
Envois, ouvertures et achats Pay Per View, pour mesurer les campagnes par créateur.
Pourboires et revenus
Événements de pourboires et cumuls de revenus sur abonnements, PPV, Private Media et pourboires.
Private Shows
Événements de planification et de fin pour les Private Shows, avec fan et durée.
Métadonnées média
Titres, tags et indicateurs de contenu pour les bibliothèques média, sans héberger le média lui-même.
Liens de suivi
Des liens d'attribution par campagne, reliés aux abonnements et achats en aval.
Notifications
Un flux de notifications que votre produit peut refléter, pour ne manquer aucune activité fan.
Webhooks
Des livraisons d'événements signées avec réessais automatiques pour abonnements, achats et messages.
Journaux d'audit
Un historique de chaque clé, connexion et changement de permission dans votre espace de travail.
Suivi de la consommation
Volume de requêtes, taux d'erreur et usage du quota par clé d'API et par créateur.
Comment fonctionne l'intégration CRM mym ?
L'intégration CRM mym pousse les enregistrements d'abonnés et de revenus vers le CRM que votre agence utilise déjà, directement ou via un workflow no-code.
Synchronisation bidirectionnelle
Les changements de statut d'abonné dans mym circulent vers le CRM, et les tags CRM peuvent alimenter de futures actions.
Mapping de champs
Faites correspondre les champs mym (formule, dépense, dernière activité) au schéma de contact de votre CRM.
Export de segment
Poussez un segment de fans, par exemple les abonnés inactifs, directement dans une liste ou une campagne CRM.
Attribution des revenus
Rattachez les revenus d'abonnement, de PPV et de pourboires au contact CRM qui les a générés.
Comment appeler mym API depuis votre stack ?
Exemples de requêtes sur trois clients courants.
# Exemple de requête vers mym API
curl https://api.apimym.com/v1/creators/cr_1042/subscribers?limit=50 \
-H "Authorization: Bearer YOUR_API_KEY"Exemples d'endpoints, de champs et de réponses.
Comment fonctionne un réessai de webhook ?
Si votre endpoint n'accuse pas réception d'une livraison, mym API réessaie selon un calendrier progressif avant de marquer l'événement en échec.
Tentative 1 - 0 s
subscription.created livré à votre endpoint, la réponse a expiré.
Tentative 2 - 30 s
Nouvel essai après un délai progressif, l'endpoint a répondu HTTP 500.
Tentative 3 - 5 min
Nouvel essai, l'endpoint a confirmé avec HTTP 200.
Tentative 4 (exemple d'échec)
Si toutes les tentatives échouaient, l'événement serait marqué en échec et visible dans le journal des livraisons.
Délais de réessai pour une livraison en échec.
Comment fonctionne la pagination ?
Les endpoints de liste utilisent une pagination par curseur, pour parcourir de manière fiable de grandes listes de fans ou d'événements.
GET /v1/creators/cr_1042/subscribers?limit=50&cursor=eyJpZCI6InN1Yl81NTEyIn0
{
"data": [ { "id": "sub_5512", "status": "active" } ],
"next_cursor": "eyJpZCI6InN1Yl81NTk5In0",
"has_more": true
}Comment les erreurs sont-elles signalées ?
Les erreurs utilisent des codes HTTP cohérents et un code d'erreur lisible par une machine, pour automatiser réessais et alertes.
HTTP/1.1 429 Too Many Requests
{
"error": {
"code": "rate_limited",
"message": "Trop de requêtes pour cette clé d'API. Réessayez après la réinitialisation.",
"retry_after_seconds": 12
}
}Comment fonctionnent les journaux d'audit et le suivi de la consommation ?
Chaque changement dans l'espace de travail et chaque requête sont enregistrés, pour que les agences voient qui a fait quoi et comment l'intégration se comporte.
Journaux d'audit
Création de clé, changement de portée, révocation de connexion et modification de permission d'équipe, chacun avec un acteur et un horodatage.
Suivi de la consommation
Des tableaux de bord pour le volume de requêtes, le taux d'erreur et le quota restant, par clé d'API et par créateur.
Questions fréquentes
- Les cas d'usage incluent la synchronisation CRM, les tableaux de bord de revenus, la segmentation des fans et des automatisations internes basées sur des clés d'API à portée limitée et des webhooks.
- Oui. Les webhooks livrent des payloads signés avec des réessais automatiques.
- Oui. Un environnement de test avec des données d'exemple permet de construire et tester une intégration avant de connecter un créateur réel.
- Le modèle repose sur des clés d'API à portée limitée, des jetons chiffrés et des payloads de webhooks signés. Consultez la page authentification pour le modèle de sécurité complet.
- Non. L'intégration CRM mym fonctionne directement ou via un outil de workflow no-code, afin que les équipes sans ressources d'ingénierie puissent aussi synchroniser leurs données.
- Oui. Les filtres d'événements font qu'un endpoint de webhook ou une synchronisation CRM ne reçoit que les types d'événements et les créateurs nécessaires, en réduisant le bruit.
Développez sur mym dès aujourd'hui
Demandez un accès anticipé à mym API et dites-nous ce que vous souhaitez créer pour vos créateurs.