文档中心 > API类目 > 淘宝客API

taobao.tbk.dg.vegas.send.status (淘宝客-推广者-红包领取状态查询)

淘宝客传入用户标识的信息,查询该用户是否有当前阶段待核销的红包(淘客接入前需签署协议 https://pub.alimama.com/fourth/protocol/common.htm?key=hangye_laxin)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
relation_id String 可选 12345 渠道管理id
special_id String 可选 12345 会员运营id
device_value String 可选 xxx 加密后的值,需用MD5加密,32位小写
device_type String 可选 IMEI 入参类型(该模式下返回的结果为模糊匹配结果,和实际情况可能存在误差): 1. IMEI 2. IDFA 3. OAID 4. MOBILE
thor_biz_code String 可选 xxx 已废弃,请勿传入
pid String 可选 mm_0_0_0 媒体pid
activity_category Number 可选 1 查询红包类型,1-超级红包,2-福利购,3-签到红包,4-福利直降,5-幸运赢免单,不传时默认查询超级红包数据

响应参数

名称 类型 示例值 描述
result_msg String 成功 返回结果描述信息
data Data 返回结果封装对象
  • result_list
  • MapData []
  • 返回结果封装对象
  • └ is_new_user
  • String
  • 1
  • 若该用户当前无待核销的红包,则返回1,若当前有待核销的红包,则返回0

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkDgVegasSendStatusRequest req = new TbkDgVegasSendStatusRequest();
req.setRelationId("12345");
req.setSpecialId("12345");
req.setDeviceValue("xxx");
req.setDeviceType("IMEI");
req.setThorBizCode("xxx");
req.setPid("mm_0_0_0");
req.setActivityCategory(1L);
TbkDgVegasSendStatusResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_dg_vegas_send_status_response>
    <result_msg>成功</result_msg>
    <data>
        <result_list>
            <map_data>
                <is_new_user>1</is_new_user>
            </map_data>
        </result_list>
    </data>
</tbk_dg_vegas_send_status_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

返回
顶部