API Penjual

• Kelola penawaran
  Buat draf, perbarui bidang aman, terbitkan, dan arsipkan melalui /api/v1/offers.
• Penuhi penjualan
  Daftar dan periksa pesanan penjual, lalu tandai sebagai terkirim dengan URL bukti opsional.
• Tetap di bawah batas
  Setiap kunci dibatasi pada 300 permintaan per menit. Respons menyertakan header X-RateLimit-*.
• Reaksi secara real-time
  Langganan peristiwa pesanan dan penawaran, atau isi ulang inventaris COMPLEX dengan webhook cadangan.

1. 1Buka Pengaturan → Pengembang dan aktifkan akses (mandiri, tanpa menunggu persetujuan).
2. 2Buat kunci API dan salin rahasia sekali (rmt_sk_live_…). Simpan di pengelola rahasia Anda.
3. 3Panggil GET /api/v1 dengan Authorization: Bearer untuk mengonfirmasi lingkup, kuota, dan operasi.

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: Daftar dan dapatkan penawaran Anda.
• offers:write: Buat, perbarui, terbitkan, dan hapus penawaran.
• orders:read: Daftar dan dapatkan pesanan penjual.
• orders:write: Tandai pesanan terkirim.
• webhooks:manage: Dikhususkan untuk pengelolaan webhook API Terbuka di masa depan. Konfigurasikan endpoint di pengaturan Pengembang hari ini.

• Format JSON mengirimkan amplop terstruktur dengan id, tipe, dibuat, dan data.
• Format Discord mengirimkan embed kaya dengan tautan pesanan atau penawaran.
• Tanda tangan opsional menggunakan X-RMT-Timestamp dan X-RMT-Signature (skema yang sama seperti cadangan).
• Riwayat pengiriman muncul di bawah setiap endpoint sehingga Anda dapat mencoba ulang kegagalan. Endpoint otomatis berhenti setelah kegagalan berulang.

{
  "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…"
}

• Stok lokal selalu diutamakan; webhook hanya mengisi kekurangan.
• Konfigurasikan default tingkat penawaran, atau ganti per opsi harga, di langkah Item editor penawaran.
• Hanya HTTPS. Tanda tangan HMAC opsional cocok dengan webhook keluar (X-RMT-Event: reserve.item).
• Pengujian di editor mengirim dryRun: true. Di halaman pesanan, gunakan Retry reserve setelah memperbaiki endpoint Anda.

{
  "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

  Header Authorization atau X-Api-Key hilang.

• API_KEY_INVALID

  401

  Kunci tidak dikenal, dicabut, kedaluwarsa, atau akses pengembang dinonaktifkan.

• SCOPE_MISSING

  403

  Kunci tidak memiliki lingkup yang diperlukan oleh endpoint.

• RATE_LIMITED

  429

  Terlalu banyak permintaan. Hormati Retry-After dan X-RateLimit-Reset.

• RESERVE_FAILED

  400

  Webhook cadangan habis waktu, mengembalikan data tidak valid, atau melewatkan bidang yang diperlukan.

Respons yang berhasil menyertakan X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset.