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

cainiao.pickup.business.adv.multi.get (菜鸟商家寄件获取营销文案信息(支持PC,移动多端的信息获取))

菜鸟裹裹的各种营销,通知等文案信息的获取,支持PC,移动多端

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
location String 可选 bannerAdv
  • 默认值:bannerAdv
  • 查询某个位置上需要展示的广告,线下约定入参

    响应参数

    名称 类型 示例值 描述
    result TdOpenServiceResult {} 返回结果
    • data
    • MarketingSenseEntryInfoAll
    • {}
    • 返回对象
    • mobile
    • MarketingSenseEntryInfo
    • {}
    • 移动端营销文案展示
    • └ extent_info
    • String
    • 扩展信息示例
    • 预留为扩展信息
    • └ title
    • String
    • 3月特惠寄
    • 该营销文案的标题
    • └ copy_url
    • String
    • https://www.google.com/search?q=mtop.cainiao.billing.price.query&oq=mtop.cainiao.billing.price.query&aqs=chrome..69i57j69i60.3542j0j4&sourceid=chrome&ie=UTF-8
    • 营销文案附带链接,为空表示不附带链接
    • └ copy
    • String
    • 上门揽收,当日取件
    • 营销文案
    • └ benefit_url
    • String
    • http://xxx
    • 利益点详细信息链接,为空表示不附带链接
    • └ benefit
    • String
    • 限时特惠
    • 利益点展示
    • └ resource_url
    • String
    • http://xxx
    • 点击营销文案资源时的跳转链接,为空表示不附带链接
    • └ resource
    • String
    • https://pic1.zhimg.com/v2-4927a421ff56548962e93b4a1e1e7413_b.jpg
    • 营销文案的资源展示(一般是图片链接)
    • pc
    • MarketingSenseEntryInfo
    • {}
    • PC端营销文案展示
    • └ extent_info
    • String
    • 扩展信息示例
    • 预留为扩展信息
    • └ title
    • String
    • 3月特惠寄
    • 该营销文案的标题
    • └ copy_url
    • String
    • https://www.google.com/search?q=mtop.cainiao.billing.price.query&oq=mtop.cainiao.billing.price.query&aqs=chrome..69i57j69i60.3542j0j4&sourceid=chrome&ie=UTF-8
    • 营销文案附带链接,为空表示不附带链接
    • └ copy
    • String
    • 上门揽件,当日取件
    • 营销文案
    • └ benefit_url
    • String
    • http://xxx
    • 利益点详细信息链接,为空表示不附带链接
    • └ benefit
    • String
    • 限时特惠
    • 利益点展示
    • └ resource_url
    • String
    • http://xxx
    • 点击营销文案资源时的跳转链接,为空表示不附带链接
    • └ resource
    • String
    • https://pic1.zhimg.com/v2-4927a421ff56548962e93b4a1e1e7413_b.jpg
    • 营销文案的资源展示(一般是图片链接)
    • └ success
    • Boolean
    • true
    • 请求是否成功
    • └ retry
    • Boolean
    • false
    • 是否需要重试
    • └ status_code
    • String
    • 系统异常
    • 错误信息
    • └ status_message
    • String
    • SYSTEM_ERROR
    • 错误码

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    CainiaoPickupBusinessAdvMultiGetRequest req = new CainiaoPickupBusinessAdvMultiGetRequest();
    req.setLocation("bannerAdv");
    CainiaoPickupBusinessAdvMultiGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <cainiao_pickup_business_adv_multi_get_response>
        <result>
            <data>
                <mobile>
                    <extent_info>扩展信息示例</extent_info>
                    <title>3月特惠寄</title>
                    <copy_url>https://www.google.com/search?q=mtop.cainiao.billing.price.query&amp;oq=mtop.cainiao.billing.price.query&amp;aqs=chrome..69i57j69i60.3542j0j4&amp;sourceid=chrome&amp;ie=UTF-8</copy_url>
                    <copy>上门揽收,当日取件</copy>
                    <benefit_url>http://xxx</benefit_url>
                    <benefit>限时特惠</benefit>
                    <resource_url>http://xxx</resource_url>
                    <resource>https://pic1.zhimg.com/v2-4927a421ff56548962e93b4a1e1e7413_b.jpg</resource>
                </mobile>
                <pc>
                    <extent_info>扩展信息示例</extent_info>
                    <title>3月特惠寄</title>
                    <copy_url>https://www.google.com/search?q=mtop.cainiao.billing.price.query&amp;oq=mtop.cainiao.billing.price.query&amp;aqs=chrome..69i57j69i60.3542j0j4&amp;sourceid=chrome&amp;ie=UTF-8</copy_url>
                    <copy>上门揽件,当日取件</copy>
                    <benefit_url>http://xxx</benefit_url>
                    <benefit>限时特惠</benefit>
                    <resource_url>http://xxx</resource_url>
                    <resource>https://pic1.zhimg.com/v2-4927a421ff56548962e93b4a1e1e7413_b.jpg</resource>
                </pc>
            </data>
            <success>true</success>
            <retry>false</retry>
            <status_code>系统异常</status_code>
            <status_message>SYSTEM_ERROR</status_message>
        </result>
    </cainiao_pickup_business_adv_multi_get_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

    返回
    顶部