Abrir API y webhooks salientes

Abre Configuración → Desarrollador, habilita el acceso, luego crea una clave de API y puntos finales de webhook opcionales.

• Las claves están limitadas a tu cuenta de vendedor y pueden ser revocadas en cualquier momento.
• El tráfico de API abierto está limitado a 300 solicitudes por minuto para cada vendedor.
• GET /api/v1 devuelve metadatos de descubrimiento para recursos disponibles.

Envía Authorization: Bearer con tu clave secreta en vivo. Prefiere solo HTTPS. Nunca incrustes claves en clientes públicos.

• offers:read: listar y obtener ofertas.
• offers:write: crear, actualizar, publicar y eliminar ofertas.
• orders:read: listar y obtener pedidos de vendedor.
• orders:write: marcar pedidos como entregados.

curl -H "Authorization: Bearer rmt_sk_live_…" https://rmt.gg/api/v1/orders

La ruta base es /api/v1. Las respuestas exitosas incluyen X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset. GET /api/v1 devuelve un catálogo de operaciones legible por máquina que coincide con este artículo.

• GET /api/v1: descubrimiento (cualquier clave válida).
• GET /api/v1/offers: listar ofertas (offers:read).
• POST /api/v1/offers: crear borrador (offers:write).
• GET /api/v1/offers/:urlOrId: obtener oferta (offers:read).
• PATCH /api/v1/offers/:urlOrId: actualizar campos de oferta (offers:write).
• DELETE /api/v1/offers/:urlOrId: eliminar o archivar (offers:write).
• POST /api/v1/offers/:urlOrId/publish: publicar (offers:write).
• GET /api/v1/orders: listar ventas (orders:read).
• GET /api/v1/orders/:uid: obtener pedido (orders:read).
• POST /api/v1/orders/:uid/deliver: marcar como entregado (orders:write).

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

Los identificadores de oferta aceptan el slug de URL pública o el id numérico. Las respuestas omiten el id interno y sellerId. Las filas de stock, precios de opciones, medios y atributos se gestionan en el editor de vendedor (o futuros puntos finales), no a través de PATCH aún.

curl -H "Authorization: Bearer rmt_sk_live_…" "https://rmt.gg/api/v1/offers?archive=active"

curl -X POST -H "Authorization: Bearer rmt_sk_live_…" https://rmt.gg/api/v1/offers

curl -H "Authorization: Bearer rmt_sk_live_…" https://rmt.gg/api/v1/offers/YOUR_OFFER_URL

curl -X PATCH -H "Authorization: Bearer rmt_sk_live_…" -H "Content-Type: application/json" https://rmt.gg/api/v1/offers/YOUR_OFFER_URL -d @body.json

{
  "title": "Título actualizado",
  "description": "Descripción para el comprador",
  "visibility": "PUBLICO",
  "categoryId": 12,
  "offeringId": 34,
  "thumbnail": "https://…",
  "offerType": "CUENTA",
  "listingMode": "ESTÁNDAR"
}

curl -X POST -H "Authorization: Bearer rmt_sk_live_…" -H "Content-Type: application/json" https://rmt.gg/api/v1/offers/YOUR_OFFER_URL/publish -d '{"visibility":"PUBLICO"}'

curl -X DELETE -H "Authorization: Bearer rmt_sk_live_…" https://rmt.gg/api/v1/offers/YOUR_OFFER_URL

Los pedidos están limitados a tu cuenta de vendedor. Los detalles de facturación del comprador pueden ser redactados. Usa el uid de pedido público (no solo la referencia opaca) para obtener y entregar.

curl -H "Authorization: Bearer rmt_sk_live_…" "https://rmt.gg/api/v1/orders?status=PAID&limit=20&sort=newest"

curl -H "Authorization: Bearer rmt_sk_live_…" https://rmt.gg/api/v1/orders/ORDER_UID

curl -X POST -H "Authorization: Bearer rmt_sk_live_…" -H "Content-Type: application/json" https://rmt.gg/api/v1/orders/ORDER_UID/deliver -d @evidence.json

{
  "evidence": [
    "https://cdn.example.com/proof-1.png"
  ]
}

Los errores devuelven JSON { error, code? }. El límite de tasa es de 300 solicitudes por minuto por clave de API.

• 401 API_KEY_REQUIRED o API_KEY_INVALID.
• 403 SCOPE_MISSING cuando la clave carece del alcance del punto final.
• 404 No encontrado para ofertas o pedidos que no posees (el mismo mensaje de cualquier manera).
• 429 RATE_LIMITED con Retry-After y encabezados X-RateLimit-*.
• 400 por fallos de validación (publicar incompleto, entrega no permitida, PATCH vacío).

Suscríbete a order.paid, order.delivered, order.completed, order.refunded y order.disputed. Elige JSON para tu servidor o Discord para incrustaciones de canal. La firma opcional utiliza X-RMT-Timestamp y X-RMT-Signature.

• El formato de Discord publica incrustaciones ricas con un enlace de pedido y nombre de oferta.
• El formato JSON publica un cuerpo estructurado que incluye nombres de ofertas y elementos de línea.
• Si estableces un secreto, verifica que HMAC-SHA256 de timestamp.body sea igual al hex de v1=.
• El historial de entrega aparece bajo cada punto final para que puedas reintentar fallos.

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

Calcula HMAC-SHA256 sobre la cadena timestamp + "." + rawBody usando tu secreto de punto final. Compara con el hex después de v1=.

import crypto from "crypto";
const expected = crypto
  .createHmac("sha256", secret)
  .update(`${timestamp}.${rawBody}`)
  .digest("hex");
const ok = expected === signature.replace(/^v1=/, "");