注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 千牛接口

taobao.jindoucloud.message.authorize.permit (卖家工作台的用户订阅消息类型)

卖家工作台的用户订阅消息类型

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
sub_userid Number 可选 123456 子账号userid
topics String 可选 item;trade 订阅的消息类目
status String 可选 all;all;ItemAdd,ItemUpdate 订阅的消息状态
stop Boolean 可选 true
  • 默认值:false
  • 是否需要听到用户的授权
    open_sub_info String 可选 {"item":["ItemAdd","ItemUpdate"],"trade":["TradeAdd","TradeDeelte"]} json结构,用于告诉服务端那些消息是需要开通的
    stop_sub_info String 可选 {"item":["ItemAdd","ItemUpdate"],"trade":["TradeAdd","TradeDeelte"]} 告诉服务端那些消息类型是关闭的
    client_info String 可选 type=IPHONE&version=1.4 客户端的版本信息
    category_action Number 可选 1 1 订阅一级类目 2 取消订阅一级类目

    响应参数

    名称 类型 示例值 描述
    authorize_info AuthorizeInfo 授权结果
    • └ status
    • String
    • valid_session
    • 开通的结果
    • └ created
    • Date
    • 2000-01-01 00:00:00
    • 开通的时间
    • subscriptions
    • Subscription []
    • 订阅的类型
    • └ topic
    • String
    • trade
    • 增量消息所属的主题。 可选值 trade(交易类型) item(商品类型) refund(退款类型)
    • └ status
    • String
    • ItemAdd
    • 增量消息的状态(隶属于主题)。具体选值请见:商品消息状态、退款消息状态、交易消息状态中的说明。

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    JindoucloudMessageAuthorizePermitRequest req = new JindoucloudMessageAuthorizePermitRequest();
    req.setSubUserid(123456L);
    req.setTopics("item;trade");
    req.setStatus("all;all;ItemAdd,ItemUpdate");
    req.setStop(true);
    req.setOpenSubInfo("{\"item\":[\"ItemAdd\",\"ItemUpdate\"],\"trade\":[\"TradeAdd\",\"TradeDeelte\"]}");
    req.setStopSubInfo("{\"item\":[\"ItemAdd\",\"ItemUpdate\"],\"trade\":[\"TradeAdd\",\"TradeDeelte\"]}");
    req.setClientInfo("type=IPHONE&version=1.4");
    req.setCategoryAction(1L);
    JindoucloudMessageAuthorizePermitResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <jindoucloud_message_authorize_permit_response>
        <authorize_info>
            <status>valid_session</status>
            <created>2000-01-01 00:00:00</created>
            <subscriptions>
                <subscription>
                    <topic>trade</topic>
                    <status>ItemAdd</status>
                </subscription>
            </subscriptions>
        </authorize_info>
    </jindoucloud_message_authorize_permit_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

    返回
    顶部