文档中心 > API类目 > 淘宝互动平台开放招募

taobao.igo.game.event.report (互动开放游戏事件上报API)

互动开放游戏事件上报API

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
event GameEventDTO 必须 游戏事件
  • └ app_id
  • Number
  • 必须
  • 123
  • 应用 appId
  • └ app_key
  • String
  • 必须
  • this is my appkey
  • 应用appKey
  • └ open_id
  • String
  • 必须
  • 123fdcd
  • 用户openId
  • └ type
  • String
  • 必须
  • type
  • 事件类型
  • └ delta
  • Number
  • 必须
  • 500
  • 变化量
  • └ mission_id
  • Number
  • 可选
  • 123
  • 任务id,平台分配
  • └ time
  • Number
  • 必须
  • 1669972264837
  • 发生时间,毫秒时间戳
  • └ id
  • String
  • 必须
  • PKWIN5543
  • 事件唯一ID,用户幂等
  • └ extend_info
  • String
  • 可选
  • {"key":"value"}
  • 扩展参数,可空

响应参数

名称 类型 示例值 描述
result IgoResult 返回结果
  • └ success
  • Boolean
  • true
  • 调用是否成功
  • └ completed
  • Boolean
  • true
  • 是否完成
  • └ retryable
  • Boolean
  • true
  • 调用失败后能否重试
  • └ biz_code
  • String
  • SUCCESS
  • 错误码
  • └ biz_msg
  • String
  • bizMsg
  • 错误描述
  • └ model
  • Boolean
  • true
  • 固定字段

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
IgoGameEventReportRequest req = new IgoGameEventReportRequest();
IgoGameEventReportRequest.GameEventDTO obj1 = new IgoGameEventReportRequest.GameEventDTO();
obj1.setAppId(123L);
obj1.setAppKey("this is my appkey");
obj1.setOpenId("123fdcd");
obj1.setType("type");
obj1.setDelta(500L);
obj1.setMissionId(123L);
obj1.setTime(1669972264837L);
obj1.setId("PKWIN5543");
obj1.setExtendInfo("{\"key\":\"value\"}");
req.setEvent(obj1);
IgoGameEventReportResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<igo_game_event_report_response>
    <result>
        <success>true</success>
        <completed>true</completed>
        <retryable>true</retryable>
        <biz_code>SUCCESS</biz_code>
        <biz_msg>bizMsg</biz_msg>
        <model>true</model>
    </result>
</igo_game_event_report_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部