注意: 此功能目前在封闭测试阶段,它将无法正常工作,除非你的游戏是在测试计划中。如果你觉得你是一个很好的测试此功能的候选人,那么 请 告诉我们

收费道具/物品网络服务API

Kongregate物品API允许你在玩家的库存中查询相关物品信息以及使用限制使用的物品。这可与client sideclient sideAPI结合来购买物品。

请确保您已阅读Kreds Primer大概了解道具收费是如何在Kongregate上运作的。

请求可用的物品列表

这个HTTP端点允许你为你的游戏请求可用的物品列表。

GET url: http://www.kongregate.com/api/items.json
需要参数:
  api_key: 分配给你游戏的API密钥

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

只有成功:
  items: 一个项目对象的数组
  id: 物品独特的整数id
  identifier: 物品的字符串标识符
  name: 物品的名称
  description: 物品的说明
    price: 一个整数含有kreds上该物品的价格
    tags: 一个含有该物品标签的字符串数组

例如:请求所有物品

GET http://www.kongregate.com/api/items.json?api_key=MyApiKey

{success:true, 
 items:[
  {id:1,identifier:"sharp-sword",name:"Sharp Sword",description:"A sharp sword",price:10,tags:["sword","awesome"]},
  {id:2,identifier:"dull-sword",name:"Dull Sword",description:"A dull sword",price:1,tags:["sword","awesome"]},
  {id:3,identifier:"axe",name:"Axe",description:"An Axe",price:10,tags:["axe"]}
 ]}

请求用户的库存

这个HTTP端点允许您请求属于一个用户的物品列表。这些物品实例作为参考。物品实例只会返回此方法如果它们有剩余的用途,或是无限使用的物品。

GET url: http://www.kongregate.com/api/user_items.json
需要参数:
  api_key: 你游戏的API密钥
  user_id: 用户请求物品的的user_id

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

只有成功:
  items: 一个项目对象的数组
  id: 物品独特的整数帐号
  identifier: 物品的字符串标识符
  name: 物品的名称
  description: 物品的说明
  remaining_uses: 这个物品的剩余使用次数,或无限使用
  data: 你连接到登出时间的可选的数据字符串

例如:为一个用户请求所有物品

GET http://www.kongregate.com/api/user_items.json?api_key=MyApiKey&user_id=765

{success:true, 
 items:[
  {id:100,identifier:"sharp-sword",name:"Sharp Sword",description:"A sharp sword",remaining_uses:null,data:null},
  {id:101,identifier:"potion",name:"Potion",description:"A Healing Poition",remaining_uses:10,data:null},
 ]}

使用一个物品

这个HTTP端点允许您使用属于某个用户的一个有限使用的物品。你必须通过在该物品实例的id来使用。此id可以从用户的库存中获得。重要的是要注意,这和 物品id不同,不是从物品函数返回。对一个无限使用的物品调用这个动作将成功返回,但没有任何效果。

POST url: http://www.kongregate.com/api/use_item.json
需要参数:
  api_key: 你游戏的API密钥
  game_auth_token: 用户的game_auth_token
  user_id: 用户的用户帐号
  id: 要使用的实例物品帐号(来自用户的仓库)

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

只有成功:
  remaining_uses: 物品实例的新的剩余使用次数
  usage_record_id: 这个转换中使用记录的独有的帐号

例如:使用一个有限使用的物品

POST http://www.kongregate.com/api/use_item.json
 POST data:
  api_key=MyApiKey
  game_auth_token=GameAuthToken
  user_id=765
  id=101

{success:true, remaining_uses:9, usage_record_id:7653}

Edit | Translate | Destroy