APIとアウトバウンドウェブフックを開く

設定→開発者を開き、アクセスを有効にし、APIキーとオプションのウェブフックエンドポイントを作成します。

• キーはあなたのセラーアカウントにスコープされ、いつでも取り消すことができます。
• オープンAPIトラフィックは、各セラーに対して1分あたり300リクエストに制限されています。
• GET /api/v1は、利用可能なリソースの発見メタデータを返します。

ライブシークレットキーでAuthorization: Bearerを送信します。HTTPSのみを優先してください。公開クライアントにキーを埋め込まないでください。

• offers:read: オファーのリストを取得。
• offers:write: オファーを作成、更新、公開、削除。
• orders:read: セラーの注文をリスト取得。
• orders:write: 注文を配達済みにマーク。

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

ベースパスは /api/v1 です。成功したレスポンスには X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset が含まれます。GET /api/v1 はこの記事に一致する機械可読の操作カタログを返します。

• GET /api/v1: ディスカバリー（有効なキー）。
• GET /api/v1/offers: オファーのリストを取得（offers:read）。
• POST /api/v1/offers: ドラフトを作成（offers:write）。
• GET /api/v1/offers/:urlOrId: オファーを取得（offers:read）。
• PATCH /api/v1/offers/:urlOrId: オファーのフィールドを更新（offers:write）。
• DELETE /api/v1/offers/:urlOrId: 削除またはアーカイブ（offers:write）。
• POST /api/v1/offers/:urlOrId/publish: 公開（offers:write）。
• GET /api/v1/orders: 売上をリスト取得（orders:read）。
• GET /api/v1/orders/:uid: 注文を取得（orders:read）。
• POST /api/v1/orders/:uid/deliver: 配達済みにマーク（orders:write）。

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

オファー識別子は公開URLスラグまたは数値IDを受け入れます。レスポンスには内部IDとsellerIdは含まれません。ストック行、オプション価格、メディア、属性はセラーエディタ（または将来のエンドポイント）で管理され、まだPATCHでは行えません。

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": "更新されたタイトル",
  "description": "バイヤー向けの説明",
  "visibility": "PUBLIC",
  "categoryId": 12,
  "offeringId": 34,
  "thumbnail": "https://…",
  "offerType": "ACCOUNT",
  "listingMode": "STANDARD"
}

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

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

注文はあなたのセラーアカウントにスコープされています。バイヤーの請求情報は削除される場合があります。取得と配達には公開注文UID（不透明な参照だけではなく）を使用してください。

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

エラーはJSON { error, code? } を返します。レート制限はAPIキーごとに1分あたり300リクエストです。

• 401 API_KEY_REQUIRED または API_KEY_INVALID。
• 403 SCOPE_MISSING キーがエンドポイントスコープを欠いている場合。
• 404 あなたが所有していないオファーまたは注文が見つかりません（どちらの場合も同じメッセージ）。
• 429 RATE_LIMITED Retry-After と X-RateLimit-* ヘッダー付き。
• 400 検証失敗の場合（公開不完全、配達不許可、空のPATCH）。

order.paid、order.delivered、order.completed、order.refunded、order.disputedを購読します。サーバー用にJSONを選択するか、Discord用にチャンネル埋め込みを選択します。オプションの署名はX-RMT-TimestampとX-RMT-Signatureを使用します。

• Discord形式は、注文リンクとオファー名を含むリッチ埋め込みを投稿します。
• JSON形式は、オファー名とラインアイテムを含む構造化されたボディを投稿します。
• 秘密を設定した場合、timestamp.bodyのHMAC-SHA256がv1=署名の16進数と等しいことを確認します。
• 配達履歴は各エンドポイントの下に表示されるため、失敗を再試行できます。

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

timestamp + "." + rawBodyの文字列に対してHMAC-SHA256を計算します。v1=の後の16進数と比較します。

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