跳转至

Hive 服务器 API 参考

本指南解释了使用 Hive 平台所需的 Hive 服务器 API;Auth v4 令牌验证 APIIAP v4 收据验证 API,并概述了如何实现 项目

必需的 server API

Auth v4 令牌验证

●  API 指南: 验证身份验证 v4 令牌

令牌验证API通过验证游戏客户端在成功登录后返回的令牌验证来响应。如果游戏不允许重复登录,您必须保存已登录用户的令牌,并实现使之前登录中使用的令牌失效的功能,例如注销或游戏终止。令牌验证服务器为与海外服务器的糟糕连接提供分布式环境。如果令牌验证未通过常见的URL响应,您应该实现通过分布式环境URL再次请求验证的功能。

IAP v4 收据验证

●  API 指南: IAP v4 验证收据

收据验证 API 对应用内购买的收据进行验证,然后响应验证结果,以确定收据是否正常处理。请参阅下面的图表以了解有关 IAP v4 的购买流程的更多信息。

在将物品交付给在游戏中为该物品付款的用户之前,必须请求从 Hive 服务器验证收据。此外,您可以根据收据验证的响应 hiveiap_transaction_idhiveiap_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上。

Note

确保在 Hive 控制台的 物品管理 菜单中注册游戏服务器 URL 和物品,以便与之同步。有关物品管理的更多信息,请参见 操作 > 计费 > 物品管理 页面在 Hive 开发者处。