開発者向け公開API

インベントリの時間あたりの枠は両エンドポイントで共通です。バッチは1リクエストとして数えます。単一インベントリの応答がstale: trueの場合、この枠は消費しません。初回照会とは保存済み評価がまだないプロフィールへの照会です。

同じIPアドレスから使われるキーは、どのアカウントのものでも共通の上限を共有します：毎分240リクエスト、毎時480件のインベントリリクエスト、毎分48件の初回照会と30件のゲームコーディネーター照会。

キーの入手方法

• Steamでログインし、プロフィールの「APIキー」欄を開きます。 プロフィールへ
• Skinory登録の5分後にキーを作成できます。各アカウントは名前付きの有効なキーを最大3個持てます。
• キーが表示されるのは作成時の1回だけで、保存するのはハッシュのみです。紛失・漏洩したキーはワンクリックで無効化し、新しいキーに置き換えられます。

キーの送り方

キーはAuthorizationヘッダー（Bearerスキーム）またはX-Api-Keyヘッダーで送ります。キーが読まれるのは/api/v1だけです。ブラウザで動くコードや公開リポジトリには入れないでください。

レスポンスヘッダーとエラー

X-RateLimit-Limit

1分あたりのリクエスト上限

X-RateLimit-Remaining

現在のウィンドウで残っているリクエスト数

X-RateLimit-Reset

ウィンドウがリセットされるまでの秒数

打ち間違えたキー、不明なキー、無効化されたキーは無視されません。匿名の制限に切り替わるのではなく、WWW-Authenticate付きの401が返ります。BANされたアカウントのキーには403が返ります。制限を超えるとRetry-After付きの429が返ります。

キーを使って価格を取得

curl -H "X-Api-Key: $SKINORY_API_KEY" \
  "https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline"

キーで1つのインベントリを取得

/api/v1/inventoryにSteamID64、プロフィールURL、またはカスタム名を渡します。インベントリは公開が必要です。最大25秒待機する場合、保存済み評価（stale: true）を返す場合、またはRetry-After付きの503を返す場合があります。評価時刻はcheckedAtで確認できます。

curl --include -H "Authorization: Bearer $SKINORY_API_KEY" \
  "https://skinory.io/api/v1/inventory?steam=76561197960287930"

保存済みインベントリを一括取得

カンマ区切りで最大100件のSteamID64または/profiles/のURLを渡します。/api/v1/inventoriesはSteamに接続せず保存済み評価を読み取ります。cachedは保存済み評価あり、unknownは評価なしを示します。評価の依頼には/api/v1/inventoryを使います。

curl -H "X-Api-Key: $SKINORY_API_KEY" \
  "https://skinory.io/api/v1/inventories?steam=76561198132414056,76561197960287930"

TF2の全価格を1回のリクエストで取得

curl --compressed -H "X-Api-Key: $SKINORY_API_KEY" \
  "https://skinory.io/api/v1/games/tf2/prices"

429はAPIの上限に達したことを、503は査定待ち、またはSteamが一時的にリクエストを制限していることを示します。Retry-Afterに秒単位で示された時間は、1分を超えていてもすべて待ってください。同じプロフィールへの再試行を並行して行わないでください。