概览

Kongregate用户信息API是一个网络服务,允许游戏检索玩家的信息。这些信息包括好友名单,头像,级别等。请注意,因为用户信息网络服务不需要API密钥,因此调用客户端或服务器是安全的。

如有必要回复将分页显示,因为每个页面上限是500个好友或静音用户。你应该检查num_pages字段,以确定是否需要对任何特定的请求分页。

如果用户有设置个人资料的名单,没有游戏可以请求用户的好友名单。如果你有发出字段请求,但没有权限,它将返回到一个空数组。

用户信息网络服务

这个HTTP端口允许你请求关于一个用户的信息。

GET url: http://www.kongregate.com/api/user_info.json
请求参数:
  username or user_id: 要请求用户信息的用户名/用户帐号

可选参数:
  page_num: 要请求的数据页码
  friends:如果你要请求一个好友列表为真

回复:
  success: 真/假取决于请求是否成功
  error: 错误代码为整数,如果有的话
  error_description: 错误代码描述字符串,如果有的话

只有成功:
  page_num: 页码
  num_pages: 总页数
  user_id: 用户的Kongregate帐号
  username: 用户的用户名
  private: 如果这是个私人资料为真
  friends: 这个用户朋友的用户名数组(如有请求)
  user_vars: 一个对象,包含用户特定变量
    level: 一个整数,表示用户的水平
    avatar_url: 连接到用户全尺寸的头像的网址
    chat_avatar_url: avatar连接到用户的聊天尺寸(小)头像的网址
    game_title: 用户正在玩的游戏名称
    game_url: 连接到用户正在玩的游戏的网址
    developer: 如果用户是开发人员为真
    moderator: 如果用户是一个版主为真
    admin: 如果用户是一个管理员为真

例如:成功的一页请求

请求:

http://www.kongregate.com/api/user_info.json?username=jimgreer&friends=true

回复:

{"user_id":1,"num_pages":1, 
 "friends":["andrewgrim","jeremyvoorhis","emily_greer","greg","duncanbeevers","truegamer","BenV"],
"private":false,"page_num":1,"user_vars":{"developer":true,"moderator":true,
"chat_avatar_url":"http:\/\/cdn1.kongregate.com\/assets\/avatars\/defaults_chat_sized\/fatkid.jpg",
"admin":true,"game_title":"Smartfox API test","level":3,
"avatar_url":"http:\/\/cdn1.kongregate.com\/assets\/avatars\/defaults\/fatkid.jpg",
"game_url":"http:\/\/www.kongregate.com\/games\/jimgreer\/smartfox",
"username":"jimgreer"},"success":true,"username":"jimgreer"}

Edit | Translate | Destroy