Açık API ve dışa aktarılan web kancaları

Ayarlar → Geliştirici'yi açın, erişimi etkinleştirin, ardından bir API anahtarı ve isteğe bağlı webhook uç noktaları oluşturun.

• Anahtarlar, satıcı hesabınıza göre kapsamlandırılır ve her zaman iptal edilebilir.
• Açık API trafiği, her satıcı için dakikada 300 istekle sınırlıdır.
• GET /api/v1, mevcut kaynaklar için keşif meta verilerini döndürür.

Canlı gizli anahtarınızla Authorization: Bearer gönderin. Sadece HTTPS tercih edin. Anahtarları kamuya açık istemcilerde asla gömün.

• offers:read: teklifleri listele ve al.
• offers:write: teklifler oluştur, güncelle, yayınla ve sil.
• orders:read: satıcı siparişlerini listele ve al.
• orders:write: siparişleri teslim edildi olarak işaretle.

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

Temel yol /api/v1. Başarılı yanıtlar X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset içerir. GET /api/v1, bu makaleye uyan makine tarafından okunabilir bir işlem kataloğu döner.

• GET /api/v1: keşif (herhangi bir geçerli anahtar).
• GET /api/v1/offers: teklifleri listele (offers:read).
• POST /api/v1/offers: taslak oluştur (offers:write).
• GET /api/v1/offers/:urlOrId: teklifi al (offers:read).
• PATCH /api/v1/offers/:urlOrId: teklif alanlarını güncelle (offers:write).
• DELETE /api/v1/offers/:urlOrId: sil veya arşivle (offers:write).
• POST /api/v1/offers/:urlOrId/publish: yayınla (offers:write).
• GET /api/v1/orders: satışları listele (orders:read).
• GET /api/v1/orders/:uid: siparişi al (orders:read).
• POST /api/v1/orders/:uid/deliver: teslim edildi olarak işaretle (orders:write).

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

Teklif tanımlayıcıları, genel url slug'ını veya sayısal kimliği kabul eder. Yanıtlar iç kimlik ve sellerId'yi atlar. Stok satırları, seçenek fiyatları, medya ve özellikler satıcı editöründe (veya gelecekteki uç noktalar) yönetilir, henüz PATCH ile değil.

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": "Güncellenmiş başlık",
  "description": "Alıcıya yönelik açıklama",
  "visibility": "GENEL",
  "categoryId": 12,
  "offeringId": 34,
  "thumbnail": "https://…",
  "offerType": "HESAP",
  "listingMode": "STANDART"
}

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":"GENEL"}'

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

Siparişler, satıcı hesabınıza bağlıdır. Alıcı fatura bilgileri gizlenebilir. Al ve teslim için genel sipariş uid'sini (sadece opak referans değil) kullanın.

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"
  ]
}

Hatalar JSON { error, code? } döner. Oran limiti, her API anahtarı için dakikada 300 istektir.

• 401 API_KEY_REQUIRED veya API_KEY_INVALID.
• 403 SCOPE_MISSING, anahtar uç nokta kapsamına sahip değilse.
• 404 Teklifler veya sahip olmadığınız siparişler için bulunamadı (her iki durumda da aynı mesaj).
• 429 RATE_LIMITED, Retry-After ve X-RateLimit-* başlıkları ile.
• 400 doğrulama hataları için (yayınlama eksik, teslimat izin verilmedi, boş PATCH).

order.paid, order.delivered, order.completed, order.refunded ve order.disputed'e abone olun. Sunucunuz için JSON veya kanal gömme için Discord'u seçin. İsteğe bağlı imzalama, X-RMT-Timestamp ve X-RMT-Signature kullanır.

• Discord formatı, bir sipariş bağlantısı ve teklif adı ile zengin gömme gönderir.
• JSON formatı, teklif adları ve satır öğelerini içeren yapılandırılmış bir gövde gönderir.
• Bir gizli ayarlarsanız, timestamp.body'nin HMAC-SHA256'sinin v1= imza hex'ine eşit olduğunu doğrulayın.
• Teslimat geçmişi, her uç noktada görünür, böylece hataları yeniden deneyebilirsiniz.

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

timestamp + "." + rawBody dizesi üzerinde HMAC-SHA256 hesaplayın ve v1='den sonraki hex ile karşılaştırın.

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