在通过 API 发布或上架充值类商品前,请遵循以下验证与接口调用顺序,以确保集成参数的准确性。
1
检查商品创建资格可选
GET/api/v1/offers/creation-prevalidation
在开始配置完整的验证参数之前,调用此接口可先一步检查您的账户是否具备在平台上创建商品的资格。
2
获取支持的游戏列表必填
GET/api/v1/games
获取完整的支持游戏目录,以取得后续步骤所需的 {gameId} 唯一标识符。
3
查询特定充值参数必填
根据您选定的 {gameId},调用以下接口来收集构建充值商品所需的特定 Schema 属性:
获取指定游戏下所有可用的服务器列表。
➔ 输出参数:
serverId, categoryId
获取标准化的充值类目与产品列表。
➔ 输出参数:
topUpCategoryId
获取该游戏所允许的保障发货时间窗口。
➔ 输出参数:
deliveryGuarantee
4
创建充值商品最终步骤
POST /api/v1/offers/topup
将前面获取并映射的所有值(包括 serverId、categoryId、topUpCategoryId
和 deliveryGuarantee)整合到结构化的 JSON Payload 中,即可动态创建并上架您的充值商品。