Tout ce qu'il faut pour intégrer l'API mym

L'URL de base est https://api.apimym.com/v1. Créez votre compte, récupérez votre clé, puis faites votre premier appel en moins de deux minutes.

curl https://api.apimym.com/v1/creators/me \
  -H "Authorization: Bearer $MYM_API_KEY"

Chaque requête doit contenir l'en-tête Authorization: Bearer MYM_API_KEY. Les clés mym_live_ accèdent aux données réelles, les clés mym_test_ à un environnement de démonstration.

Les clés sont limitées à des scopes (fans:read, messages:write, transactions:read...) et à un ou plusieurs créateurs via MYM_CREATOR_SCOPE. Gardez-les côté serveur et renouvelez-les depuis votre espace en cas de fuite.

Les corps de requête et de réponse sont en JSON UTF-8. Les montants sont en centimes, les dates au format ISO 8601 UTC. Chaque réponse contient un request_id à nous transmettre en cas de support.

{
  "data": {
    "id": "crt_8f2k1",
    "username": "lea.studio",
    "subscribers_count": 1284,
    "created_at": "2025-03-14T09:12:44Z"
  },
  "meta": { "request_id": "req_01J9X4" }
}

Pour les requêtes POST, ajoutez un en-tête Idempotency-Key afin de pouvoir réessayer sans créer de doublon.

Les listes utilisent une pagination par curseur. Passez limit (1 à 100, 25 par défaut) et reprenez avec la valeur next_cursor reçue.

GET /v1/fans?limit=50&cursor=eyJpZCI6ImZhbl85MWFiIn0

{ "data": [ ... ], "meta": { "next_cursor": "eyJpZCI6ImZhbl9hMjAxIn0", "has_more": true } }

Les erreurs renvoient un code HTTP standard et un objet explicite :

{ "error": { "code": "invalid_request", "message": "Le paramètre limit doit être compris entre 1 et 100.", "request_id": "req_01J9X4" } }

Par défaut, chaque clé dispose de 120 requêtes par minute. Les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset indiquent votre consommation. En cas de 429, attendez la durée indiquée par Retry-After.

Enregistrez une URL HTTPS pour recevoir les événements en temps réel. Chaque livraison est signée en HMAC SHA-256 dans l'en-tête X-Mym-Signature. Répondez en 2xx sous 10 secondes, sinon nous réessayons jusqu'à 8 fois sur 24 heures avec un backoff exponentiel.

{
  "id": "evt_01J9X7",
  "type": "transaction.created",
  "created_at": "2026-09-24T21:04:11Z",
  "data": {
    "transaction_id": "txn_4k2p",
    "fan_id": "fan_91ab",
    "kind": "subscription",
    "amount": 1499,
    "currency": "EUR"
  }
}

import { createHmac, timingSafeEqual } from "node:crypto";

export function verify(rawBody: string, signature: string, secret: string) {
  const expected = createHmac("sha256", secret).update(rawBody).digest("hex");
  return timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
}

// En-tête : X-Mym-Signature

Créez un lien de tracking avec POST /v1/tracking/links. Les identifiants de clic (fbclid, ttclid, gclid, ScCid) sont capturés puis associés au fan lors de son abonnement ou de son achat.

Les conversions sont envoyées côté serveur à Meta, TikTok, Snapchat et Google Ads avec un event_id partagé pour la déduplication avec le pixel.

POST /v1/tracking/links
{ "name": "Campagne septembre", "destinations": ["meta", "tiktok"], "events": ["subscription", "purchase"] }

Connectez l'API à Claude, ChatGPT, Cursor ou Manus avec notre serveur MCP. Ajoutez cette configuration à votre client puis posez vos questions en langage naturel.

{
  "mcpServers": {
    "mym": {
      "command": "npx",
      "args": ["-y", "@apimym/mcp"],
      "env": { "MYM_API_KEY": "mym_live_..." }
    }
  }
}