开放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 加密和联机不支持