Hive 服务器 API 参考¶
本指南解释了使用 Hive 平台所需的 Hive 服务器 API;Auth v4 令牌验证 API 和 IAP v4 收据验证 API,并概述了如何实现 项目。
必需的 server API¶
Auth v4 令牌验证¶
● API 指南: 验证身份验证 v4 令牌
令牌验证API通过验证游戏客户端在成功登录后返回的令牌验证来响应。如果游戏不允许重复登录,您必须保存已登录用户的令牌,并实现使之前登录中使用的令牌失效的功能,例如注销或游戏终止。令牌验证服务器为与海外服务器的糟糕连接提供分布式环境。如果令牌验证未通过常见的URL响应,您应该实现通过分布式环境URL再次请求验证的功能。
IAP v4 收据验证¶
● API 指南: IAP v4 验证收据
收据验证 API 对应用内购买的收据进行验证,然后响应验证结果,以确定收据是否正常处理。请参阅下面的图表以了解有关 IAP v4 的购买流程的更多信息。
在将物品交付给在游戏中为该物品付款的用户之前,必须请求从 Hive 服务器验证收据。此外,您可以根据收据验证的响应 hiveiap_transaction_id
和 hiveiap_market_pid
来判断是否交付物品。
字段名称 | 描述 | 类型 | 必需 |
hiveiap_transaction_id | 由收据成功验证生成的交易 ID。此值保存在游戏服务器中以检查重复收据。 仅在响应代码为 0(验证成功)时交付 | 字符串 | N |
hiveiap_market_id | 区分用户支付的商店的市场代码。 1: 苹果应用商店 2: 谷歌 Play 商店 3: Lebi 4: ONE 商店 仅在响应代码为 0(验证成功)时交付 | 整数 | N |
hiveiap_transaction_id
是成功验证的收据的唯一键,该收据已发出。 为了避免重复收据,在交付物品时,该值会保存在游戏服务器中,然后您可以决定收据是否已被使用。收据验证是 Hive 服务器返还价值的唯一依据。此外,Hive 服务器无法区分收据是在购买尝试后验证的,还是由于未能发送物品而通过恢复操作验证的。hiveiap_market_pid
是从收据或收据的验证结果中提取的物品信息。通过客户端发送的物品信息存在内存变换的风险,因此您必须根据该值决定并交付物品。
项目¶
item 是一个集成和管理游戏货币和物品交付与检索功能的系统。通过 item,您可以连接到多种系统,例如优惠券系统、活动、提供墙和 CPI,以发送或检索物品,并且管理员的后台可用于手动搜索发送和检索物品的历史记录。
Item的结构是,如果Item Server 调用send item API或retrieve item API到游戏服务器,游戏服务器会响应请求。有关Server API的更多详细信息,请前往 API > Hive Server API > Billing > 与Item同步 在Hive Developers上。