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.

  1. Tentative 1 - 0 s

    subscription.created livré à votre endpoint, la réponse a expiré.

  2. Tentative 2 - 30 s

    Nouvel essai après un délai progressif, l'endpoint a répondu HTTP 500.

  3. Tentative 3 - 5 min

    Nouvel essai, l'endpoint a confirmé avec HTTP 200.

  4. 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.

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.

Commencer gratuitement