文档中心 > API类目 > 菜鸟裹裹API

cainiao.pickup.business.market.common.activity.join (根据活动领券)

裹裹商家寄件获取商家身份

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
biz_type String 可选 ISVMerchant
  • 默认值:ISVMerchant
  • 业务类型,如:ISVMerchant
    mobile String 可选 13817778888 下单操作人的手机号,用作联系,可以不填写
    join_activity_request JoinActivityRequest 可选 请求参数
    • └ activity_type
    • String
    • 必须
    • isvActivity
    • isv活动标识,如:isvActivity

    响应参数

    名称 类型 示例值 描述
    data UserRewardInfoDTO 返回对象
    • └ reward_record_id
    • String
    • RC220913554120807209515321xx
    • 权益领取记录id
    • └ reward_name
    • String
    • 支付宝3*2元券包发放0909
    • 券的名称
    biz_success Boolean true 成功或者失败
    retry Boolean false 是否需要重试
    status_message String 系统错误 如:活动已结束!
    status_code String SYS_ERROIR 错误码

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    CainiaoPickupBusinessMarketCommonActivityJoinRequest req = new CainiaoPickupBusinessMarketCommonActivityJoinRequest();
    req.setBizType("ISVMerchant");
    req.setMobile("13817778888");
    CainiaoPickupBusinessMarketCommonActivityJoinRequest.JoinActivityRequest obj1 = new CainiaoPickupBusinessMarketCommonActivityJoinRequest.JoinActivityRequest();
    obj1.setActivityType("isvActivity");
    req.setJoinActivityRequest(obj1);
    CainiaoPickupBusinessMarketCommonActivityJoinResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <cainiao_pickup_business_market_common_activity_join_response>
        <data>
            <reward_record_id>RC220913554120807209515321xx</reward_record_id>
            <reward_name>支付宝3*2元券包发放0909</reward_name>
        </data>
        <biz_success>true</biz_success>
        <retry>false</retry>
        <status_message>系统错误</status_message>
        <status_code>SYS_ERROIR</status_code>
    </cainiao_pickup_business_market_common_activity_join_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

    返回
    顶部