Kongregate网络服务API

Kongregate网络服务API的设计在于让你现有的游戏服务器与Kongregate后端连接。此连接允许用户在Kongregate上玩游戏时自动登录到你的游戏,不再需要建立一个单独的账号。


这成就了更多的无缝体验,通常会引来更多的游戏玩家和更高的评价。



请注意,现在,所有的服务器旨在只适用于服务器对服务器的目的,从客户端利用它们发出你的api_key。我们希望能在不久的将来把这些服务提供给客户端。



Kongregate客户端API


为了使用网络服务API,它需要你实现Kongregate客户端API,它可让您检索关于玩家的信息,比如他们的用户名和游戏认证令牌。



游戏API密钥

所有网络请求需要一个API密钥。您可以在这里检索你的密钥



游戏认证标记

认证标记用于验证某个Kongregate用户是不是他们自称的人物。这些标记是唯一的和每个用户和每个游戏一一对应。一些行动诸如身份验证和使用物品需要此标记,以便能成功完成。



客户端连接

用户的game_auth_token和user_ID的可以用在Kongregate 服务器API对象上的getGameAuthToken()和getUserId函数检索,例如:

 
kongregate.services.getUserId();
kongregate.services.getGameAuthToken();


你的游戏客户端随后可以通过user_ID的和game_auth_token到游戏服务器。这通常是在登录时通过发送用户名和密码给它们完成,但你也可以用任何你想要的方式去实现。

理想情况下,你的服务器应用程序应该有这种标记,以便它在需要时可以从内存中检索。




HTTP回复

HTTP状态代码将是200,只要没有内部服务器错误或预定停机时间。所有请求返回JSON字符串 –一定会有个资料库为您解析JSON的编程语言。

每个请求有一个成功的字段将是true或false,如果发生错误将是error和error_description字段。



HTTP回调

您可以指定一个API回调网址,当某些事件发生在Kongregate上时来接收通知。关于API回调的文档可以在这里找到



通过认证/Kreds开始

要开始,请阅读此文件关于请求连接认证和道具收费的步骤。



服务

认证网络服务

用户信息网络服务

道具收费/物品网络服务

徽章信息源