开放api教程

开放 API 使用教程

1. 去哪配置 API 密钥

生成密钥: 登录平台 → 左侧菜单「📦 自动发货」→ 顶部切换到「🔑 我的 API 密钥」标签 → 点击「生成 API 密钥」按钮 → 复制保存好(格式:csk_xxxxxxxxxx)

管理密钥: 在同一个页面可以:

  • 「查看」:查看密钥(仅生成时显示一次)
  • 「重置」:重新生成新密钥,旧密钥立即失效
  • 「删除」:删除密钥,删除后无法调用 API

对接阿奇索时在哪填:

  • 方式一(接口对接):把密钥发给阿奇索客服,客服帮你配置
  • 方式二(自己配置):在阿奇索后台「货源账号」里,用户 ID / 密钥字段填你的 API 密钥
  • 方式三(卡密仓库):不需要密钥,提前生成卡密导出导入仓库即可

自己开发时怎么用: 代码里把密钥放到请求头:Authorization: Bearer 你的API密钥

注意:

  • 密钥只显示一次,忘记了只能重置
  • 等同账户密码,不要泄露给他人
  • 怀疑泄露立即重置,旧密钥会失效

2. 鉴权方式

所有请求头携带:

Authorization: Bearer 你的API密钥
Content-Type: application/json

3. 接口列表

表格

接口 方式 地址 功能
查询用户信息 GET /api/user/open/info 查余额、卡密数量
生成卡密 POST /api/user/open/generate 生成卡密,自动扣费
查询卡密列表 GET /api/user/open/keys 查已生成的卡密
查询消费记录 GET /api/user/open/transactions 查消费 / 退款记录
查询游戏列表 GET /api/user/open/games 查支持的游戏
阿奇索出库接口 POST /api/user/open/agiso/CardPwd/PickupStockOut 兼容阿奇索格式

4. 生成卡密示例

请求:

POST /api/user/open/generate
{
  "appid": "730",
  "count": 1
}

返回:

{
  "ok": true,
  "keys": ["ABC123DEF456GHIJ"],
  "game_name": "Counter-Strike 2",
  "balance_after": 8.50
}

5. 你可能不知道的

  • 有清单的游戏秒生成,无清单的首次 10-30 秒
  • 卡密默认 30 天有效期,过期作废
  • 只有未使用的卡密才能回收退款
  • 每分钟最多调用 60 次,建议设 30 秒超时
  • 生成失败不扣费,只有成功才扣
  • AppID 去 Steam 商店 URL 或steamdb.info查
  • 仅支持 Steam 单机游戏,D 加密和联机不支持

6. 平台地址