API Vendeur

• Gérer les offres
  Créez des brouillons, mettez à jour des champs sécurisés, publiez et archivez via /api/v1/offers.
• Réaliser des ventes
  Listez et inspectez les commandes des vendeurs, puis marquez-les comme livrées avec des URL de preuves optionnelles.
• Rester sous la limite
  Chaque clé est limitée à 300 requêtes par minute. Les réponses incluent des en-têtes X-RateLimit-*.
• Réagir en temps réel
  Abonnez-vous aux événements de commande et d'offre, ou réapprovisionnez l'inventaire COMPLEX avec des webhooks de réserve.

1. 1Ouvrez Paramètres → Développeur et activez l'accès (auto-service, pas d'attente d'approbation).
2. 2Créez une clé API et copiez le secret une fois (rmt_sk_live_…). Conservez-le dans votre gestionnaire de secrets.
3. 3Appelez GET /api/v1 avec Authorization: Bearer pour confirmer les scopes, les quotas et les opérations.

curl -s -H "Authorization: Bearer rmt_sk_live_…" \
  https://rmt.gg/api/v1 | jq .

{
  "name": "RMT Seller Open API",
  "version": "1",
  "basePath": "/api/v1",
  "scopes": ["offers:read", "offers:write", "orders:read", "orders:write", "webhooks:manage"],
  "webhookEvents": ["order.paid", "order.delivered", "…"],
  "operations": [ /* full catalog */ ]
}

• offers:read: Lister et obtenir vos offres.
• offers:write: Créer, mettre à jour, publier et supprimer des offres.
• orders:read: Lister et obtenir les commandes des vendeurs.
• orders:write: Marquer les commandes comme livrées.
• webhooks:manage: Réservé pour la gestion future des webhooks de l'API ouverte. Configurez les points de terminaison dans les paramètres Développeur dès aujourd'hui.

• Le format JSON envoie une enveloppe structurée avec id, type, créé et données.
• Le format Discord envoie des intégrations riches avec des liens de commande ou d'offre.
• La signature optionnelle utilise X-RMT-Timestamp et X-RMT-Signature (même schéma que la réserve).
• L'historique des livraisons apparaît sous chaque point de terminaison afin que vous puissiez réessayer les échecs. Les points de terminaison se mettent automatiquement en pause après des échecs répétés.

{
  "id": "whd_…",
  "type": "order.paid",
  "created": "2026-07-23T12:00:00.000Z",
  "data": {
    "order": {
      "uid": "ord_…",
      "reference": "RMT-…",
      "status": "PAID",
      "url": "https://rmt.gg/orders/ord_…",
      "items": [ /* line items with offer names */ ]
    }
  }
}

{
  "X-RMT-Event": "order.paid",
  "X-RMT-Delivery": "whd_…",
  "X-RMT-Timestamp": "1710000000",
  "X-RMT-Signature": "v1=abc123…"
}

• Le stock local est toujours préféré ; le webhook ne remplit que le manque.
• Configurez un défaut au niveau de l'offre, ou remplacez-le par option de tarification, à l'étape Items de l'éditeur d'offres.
• HTTPS uniquement. La signature HMAC optionnelle correspond aux webhooks sortants (X-RMT-Event: reserve.item).
• Tester dans l'éditeur envoie dryRun: true. Sur la page de commande, utilisez Réessayer la réserve après avoir corrigé votre point de terminaison.

{
  "id": "rsv_…",
  "type": "reserve.item",
  "order": { "uid": "ord_…", "reference": "RMT-…", "url": "https://rmt.gg/orders/ord_…" },
  "offer": { "url": "my-offer", "title": "Game key", "pageUrl": "https://rmt.gg/offers/my-offer" },
  "option": { "id": 1, "name": "Standard" },
  "fields": [{ "id": 10, "name": "License", "type": "text", "required": true }],
  "quantity": 1
}

{
  "entries": [
    { "name": "License", "value": "AAAA-BBBB-CCCC" }
  ]
}

{
  "license": "AAAA-BBBB-CCCC",
  "email": "[email protected]",
  "password": "temporary-pass"
}

• API_KEY_REQUIRED

  401

  En-tête Authorization ou X-Api-Key manquant.

• API_KEY_INVALID

  401

  Clé inconnue, révoquée, expirée ou accès développeur désactivé.

• SCOPE_MISSING

  403

  La clé manque le scope requis par le point de terminaison.

• RATE_LIMITED

  429

  Trop de requêtes. Respectez Retry-After et X-RateLimit-Reset.

• RESERVE_FAILED

  400

  Le webhook de réservation a expiré, renvoyé des données invalides ou manqué des champs requis.

Les réponses réussies incluent X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset.