SteamAPI Helper Tool

API 文档

以下是可用的后端 API 接口说明。

0. 生成部署脚本 (通过VDF文件)

• URL:https://api.steam.al/GetCreateDeployments
• Method:POST
• Content-Type:application/json
• 说明: 此接口用于根据提供的 AppTokens 和 DepotKeys 生成部署脚本。后端现在返回一个包含多个部署配置的列表。
• 请求 Body 格式 (JSON):

  { "AppTokens": [ {"AppId": 1234, "Token": "11........"}, {"AppId": 1235, "Token": "13........."}, {"AppId": 1236, "Token": "12........"} ], "DepotKeys": [ {"DepotId": 1234, "DepotKey": "07......99a7"}, {"DepotId": 1234, "DepotKey": "ce......429c"} ]}

• 响应 Body 格式 (JSON Array of BackendApiResponse):

  [ { // First BackendApiResponse "AppNotes": "--Name: Game 1...", "AppConfigs": [100, 101], "AppTokens": [ /* ... */ ], "DepotKeys": [ /* ... */ ], "Manifests": [ {"DepotId": 101, "ManifestId": "abc", "ManifestContent":"url1"} ] }, { // Second BackendApiResponse "AppNotes": "--Name: Game 2...", "AppConfigs": [200], /* ... other fields ... */ "Manifests": [ {"DepotId": 201, "ManifestId": "xyz", "ManifestContent":"url2"} ] }]

1. 统一校验接口 (VerifyDeployments)

• URL:https://api.steam.al/VerifyDeployments
• Method:POST
• 请求 Body 格式 (JSON):

  { "AppConfigs": [1239], "AppTokens": [{ "AppId": 1234, "Token": "1123.........." }], "DepotKeys": [{ "DepotId": 1234, "DepotKey": "78....f55b6" }], "ManifestIds": [{ "DepotId": 1234, "ManifestId": "37........." }], "AppTickets": [{ "AppId": 123456, "Ticket": "3200000004000000......88946" }]}

• 响应 Body 示例 (JSON - from user):

  { "AppTokens":[ /* ... */ ], "DepotKeys":[ /* ... */ ], "ManifestIds":[ {"DepotId":2457221,"Status":"error_need_to_update","NewManifestId":"5325...","NewManifestContent":"https://..."}, {"DepotId":3361650,"Status":"success","NewManifestId":"0"} ]}

2. 校验 Depot Keys

• URL:https://api.steam.al/VerifyDepotKeys
• Method:POST
• Content-Type:application/json
• 请求 Body 格式 (JSON Array, Max 10 items per request):

  [ {"DepotId": 123451, "DepotKey": "d709f6...f92e"}, {"DepotId": 123452, "DepotKey": "3c0c23...16bb"}, ...]

  • `DepotId`: (uint) Depot ID
  • `DepotKey`: (string) 64位十六进制字符串
• 响应 Body 格式:

  { "Results": [ { "DepotId": 123451, "Status": "success" // or error code }, { "DepotId": 123452, "Status": "error_depot_verification_failed" }, ... ]}

• 相关错误码: `error_invalid_depot_id_value`, `error_invalid_depot_id_format`, `error_missing_depot_id`, `error_invalid_key_format`, `error_missing_depot_key`, `error_depot_verification_failed`

3. 校验 App Tokens

• URL:https://api.steam.al/VerifyAppTokens
• Method:POST
• Content-Type:application/json
• 请求 Body 格式 (JSON Array, Max 10 items per request):

  [ {"AppId": 12340, "Token": "543565765765876"}, {"AppId": 12350, "Token": "342544364576575"}, ...]

  • `AppId`: (uint) App ID
  • `Token`: (ulong) App Token (作为 JSON number 或 string 发送皆可, 但 JavaScript 处理大数字需注意精度，建议用 string)
• 响应 Body 格式:

  { "Results": [ { "AppId": 12340, "Status": "success" // or error code }, { "AppId": 12350, "Status": "error_apptoken_verification_failed" }, ... ]}

• 相关错误码: `error_invalid_app_id_value`, `error_invalid_app_id_format`, `error_missing_app_id`, `error_invalid_token_format`, `error_missing_token`, `error_apptoken_verification_failed`

3. 校验 Package Tokens

• URL:https://api.steam.al/VerifyPackTokens
• Method:POST
• Content-Type:application/json
• 请求 Body 格式 (JSON Array, Max 10 items per request):

  [ {"PackageId": 2345, "Token": "14556567658"}, {"PackageId": 3456, "Token": "123467891"}, ...]

  • `PackageId`: (uint) Package ID
  • `Token`: (ulong) Package Token (作为 JSON number 或 string 发送皆可, 但 JavaScript 处理大数字需注意精度，建议用 string)
• 响应 Body 格式:

  { "Results": [ { "PackageId": 2345, "Status": "success" // or error code }, { "PackageId": 3456, "Status": "error_packtoken_verification_failed" }, ... ]}

• 相关错误码: `error_invalid_package_id_value`, `error_invalid_package_id_format`, `error_missing_package_id`, `error_invalid_token_format`, `error_missing_token`, `error_packtoken_verification_failed`

通用错误码

• `error_unknown_validation_issue`: 未知校验问题
• `error_processing_failed`: 后端处理失败 (例如，服务器内部错误)
• `error_too_many_items`: 请求包含的条目超过10个 (前端应避免，但后端也可能返回)