文档中心 > API类目 > 消息服务API

taobao.tmc.topic.group.add (点对点消息topic分组路由)

广播消息归属用户, 请使用用户分组, 否则当用户处于default(未自定义分组时)会被此api影响路由; 点对点消息归属appkey, 可使用本api调整(未被指定targetGroup的)指定topic路由到目标分组; 把指定topic的消息路由到自定义分组。(前提:发送方未指定targetGroup); 如果是需要授权的消息,分组路由先判断用户分组(使用taobao.tmc.group.add添加的非default分组),用户分组不存在时,才会判断topic分组路由

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
group_name String 必须 group_test 消息分组名,如果不存在,会自动创建
topics String [] 必须 taobao_trade_TradeClose,taobao_trade_TradeSuccess
  • 最大列表长度:20
  • 消息topic名称,多个以逗号(,)分割

    响应参数

    名称 类型 示例值 描述
    result Boolean true true

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmcTopicGroupAddRequest req = new TmcTopicGroupAddRequest();
    req.setGroupName("group_test");
    req.setTopics("taobao_trade_TradeClose,taobao_trade_TradeSuccess");
    TmcTopicGroupAddResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmc_topic_group_add_response>
        <result>true</result>
    </tmc_topic_group_add_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

    返回
    顶部