文档中心 > API类目 > 本地生活用户增长互动业务

alibaba.alsc.growth.interactive.mini.game.integral.grant (本地生活用户增长互动小游戏积分发放)

本地生活用户增长互动小游戏积分发放

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
mini_game_grant_integral_request MiniGameGrantIntegralRequest 必须 小游戏积分发放请求参数
  • └ amount
  • Number
  • 必须
  • 10
  • 积分发放数量
  • └ act_id
  • String
  • 必须
  • 20220721153243098165495747
  • 活动id
  • └ biz_scene
  • String
  • 必须
  • IDIOM
  • 业务场景
  • └ game_acc_id
  • String
  • 可选
  • 23432
  • 游戏账号,成语场景下必填
  • └ collection_ids
  • String []
  • 必须
  • ["20220721153243102940224249"]
  • 组建集id集合
  • └ request_id
  • String
  • 必须
  • adfafadfa
  • 请求id(幂等id,非链路id),不超过128位,相同幂等号,发放数量也要保持相同,否则会幂等异常
  • └ property_id
  • String
  • 必须
  • 1261
  • 资产id
  • └ open_id
  • String
  • 可选
  • AAFh0z9sAOAaPm8T4L3O22tX
  • openId,非成语场景下必填
  • └ ext_params
  • String
  • 可选
  • {"bizName":"游戏名称用于乐园币明细展示,中文游戏名称","gameStage":"什么场景下发放的乐园币(具体参考描述中链接的文档)","gameOperateName":"什么场景发放乐园币","gameTaskId":"和任务相关的,给任务id","ua":"h5从奇门dispatch透传参数中取,小程序从header取","wua":"h5从奇门dispatch透传参数中取,小程序从header取","x-mini-wua":"h5从奇门dispatch透传参数中取,小程序从header取","x-umt":"h5从奇门dispatch透传参数中取,小程序从header取"}
  • 按实际情况填写相关参数(非业务参数,从奇门dispatch接口转发过去的最早h5方式,可以直接把透传过去的参数再透传过来,小程序方式接入的从header中获取,透传参数具体参考下述链接对应的文档:https://bdshhd.yuque.com/org-wiki-bdshhd-refgtt/white-paper/zwf4r3v9hxhaabxa

响应参数

名称 类型 示例值 描述
data MiniGameGrantIntegralDTO 积分发放返回对象
  • └ account_value
  • Number
  • 1000
  • 账户值
  • └ real_grant_value
  • Number
  • 1
  • 实际发放值
biz_success Boolean true 接口调用是否成功
biz_error_code String SYSTEM_ERROR 错误码
biz_error_msg String 系统异常 错误信息
trace_id String 8ed9asdf09duf8sa9f 链路id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlscGrowthInteractiveMiniGameIntegralGrantRequest req = new AlibabaAlscGrowthInteractiveMiniGameIntegralGrantRequest();
AlibabaAlscGrowthInteractiveMiniGameIntegralGrantRequest.MiniGameGrantIntegralRequest obj1 = new AlibabaAlscGrowthInteractiveMiniGameIntegralGrantRequest.MiniGameGrantIntegralRequest();
obj1.setAmount(10L);
obj1.setActId("20220721153243098165495747");
obj1.setBizScene("IDIOM");
obj1.setGameAccId("23432");
obj1.setCollectionIds(""20220721153243102940224249"");
obj1.setRequestId("adfafadfa");
obj1.setPropertyId("1261");
obj1.setOpenId("AAFh0z9sAOAaPm8T4L3O22tX");
obj1.setExtParams("{\"bizName\":\"游戏名称用于乐园币明细展示,中文游戏名称\",\"gameStage\":\"什么场景下发放的乐园币(具体参考描述中链接的文档)\",\"gameOperateName\":\"什么场景发放乐园币\",\"gameTaskId\":\"和任务相关的,给任务id\",\"ua\":\"h5从奇门dispatch透传参数中取,小程序从header取\",\"wua\":\"h5从奇门dispatch透传参数中取,小程序从header取\",\"x-mini-wua\":\"h5从奇门dispatch透传参数中取,小程序从header取\",\"x-umt\":\"h5从奇门dispatch透传参数中取,小程序从header取\"}");
req.setMiniGameGrantIntegralRequest(obj1);
AlibabaAlscGrowthInteractiveMiniGameIntegralGrantResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alsc_growth_interactive_mini_game_integral_grant_response>
    <data>
        <account_value>1000</account_value>
        <real_grant_value>1</real_grant_value>
    </data>
    <biz_success>true</biz_success>
    <biz_error_code>SYSTEM_ERROR</biz_error_code>
    <biz_error_msg>系统异常</biz_error_msg>
    <trace_id>8ed9asdf09duf8sa9f</trace_id>
</alibaba_alsc_growth_interactive_mini_game_integral_grant_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

返回
顶部