文档中心 > API类目 > 淘金币API

taobao.coin.seller.give (卖家活动淘金币发放)

卖家活动淘金币发放。本接口需要淘金币平台运营小二为您的APPKEY配置之后,才能使用。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
buyer_nick String 必须 demo 用户nick,使用top混淆nick
amount Number 必须 123 本次发放金币数
attributes Json 可选 APP自行扩展字段,key-value对
comments String 可选 游戏通关奖励 本次流转备注
out_id Number 可选 123 与本次金币操作关联的外键ID(app范围内唯一),如提供,作为本接口幂等校验的依据。
tb_activity_id Number 必须 123 淘金币平台活动ID
token String 必须 1d502118-cd63-4657-8e40-612d52eb5011 淘金币令牌

响应参数

名称 类型 示例值 描述
succ_amount Number 123 成功发放的金币数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CoinSellerGiveRequest req = new CoinSellerGiveRequest();
req.setBuyerNick("demo");
req.setAmount(123L);
req.setAttributesString("");
req.setComments("游戏通关奖励");
req.setOutId(123L);
req.setTbActivityId(123L);
req.setToken("1d502118-cd63-4657-8e40-612d52eb5011");
CoinSellerGiveResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<coin_seller_give_response>
    <succ_amount>123</succ_amount>
</coin_seller_give_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>

错误码解释

错误码 错误描述 解决方案
isp.give-fail:* 淘金币发放失败:[详细原因] 根据出错提示处理。如果需要淘金币平台排查,需要提供错误信息中的traceId值。
isv.activity-not-exists 不存在卖家活动 需要检查APP是否在淘金币平台创建过活动
isv.activity-invalid 无效的卖家活动 活动可能已结束,确认淘金币平台活动状态
isv.activity-not-running 卖家活动尚未运行 检查当前是否处于活动周期之内
isv.parameter-invalid 无效的参数 检查参数
isp.token-invalid 淘金币token无效 可能是token已经失效(1天内,时间可能被调整),需要重新获取token
isp.systerm-error 系统错误,本次发放失败 记录日志,如需淘金币服务端配合排查,需提供traceId

API工具

如何获得此API

FAQ

返回
顶部