在通过 API 发布或上架游戏币类商品(Currency Offers)之前,请遵循以下分步验证及接口调用顺序,以确保集成参数的准确性。
1
检查商品创建资格可选
GET/api/v1/offers/creation-prevalidation
在构建完整的 Schema 请求载荷前,可调用此接口检查您的账户是否具备在平台上创建商品的资格。
2
获取支持的游戏列表必填
GET/api/v1/games
获取平台支持的所有游戏列表及其对应的 ID 元数据,以便准确指定特定的 {gameId}。
3
查询特定游戏币参数必填
根据您作为目标的 {gameId},获取用于正确映射和验证最终请求体的必要元数据:
获取该游戏可用的服务器列表及父级分组。
➔ 输出参数:
serverId, categoryId
获取标准的游戏币子类型(仅适用于存在多种货币的游戏)。
➔ 输出参数:
currencyTypeId
获取合法的发货时间保障窗口选项。
➔ 输出参数:
deliveryGuarantee
4
创建并发布游戏币商品最后一步
POST /api/v1/offers/currency
将从步骤 2和步骤 3中获取的所有参数组装到您的请求上下文 Schema 中,以完成构建、推送并让您的游戏币商品正式公开上架。