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

文档中心 > API类目 > 千牛业务API

taobao.rosefinch.dingtalk.send (淘宝消息开放平台dingtalk消息发送代理接口)

淘宝消息开放客服务商vpc环境调用dingtalk发送告警消息代理接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
auth_param IsvAuthParamDo 必须 身份验证
  • └ tenant_id
  • Number
  • 必须
  • 1
  • 淘宝消息平台分配的租户id
  • └ acc_token
  • String
  • 必须
  • xxx
  • 淘宝消息平台分配的请求token
msg DingTalkMsgDo 必须 消息
  • text_msg
  • TextMsg
  • 可选
  • 文本消息
  • └ content
  • String
  • 可选
  • xxx
  • 文本内容
  • └ is_at_all
  • Boolean
  • 可选
  • true
  • at all
  • └ at_mobiles
  • String []
  • 可选
  • ["15924xxxxxx"]
  • at 个人,值为手机号字符串
  • link_msg
  • LinkMsg
  • 可选
  • link消息
  • └ text
  • String
  • 可选
  • xxxx
  • link消息卡片内容
  • └ pic_url
  • String
  • 可选
  • http://img.alicdn.com/xxx.jpg
  • 图片链接
  • └ message_url
  • String
  • 可选
  • http://www.taobao.com
  • 消息点击跳转目标url
  • └ title
  • String
  • 可选
  • xxxx
  • link消息卡片标题
  • └ webhook_access_token
  • String
  • 可选
  • xxxx
  • 钉钉群机器人webhook的accessToken(不要放url)

响应参数

名称 类型 示例值 描述
result Result 接口返回model
  • └ success
  • Boolean
  • false
  • 是否成功
  • └ code
  • String
  • code
  • └ message
  • String
  • message
  • └ value
  • Number
  • 当天剩余调用次数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
RosefinchDingtalkSendRequest req = new RosefinchDingtalkSendRequest();
RosefinchDingtalkSendRequest.IsvAuthParamDo obj1 = new RosefinchDingtalkSendRequest.IsvAuthParamDo();
obj1.setTenantId(1L);
obj1.setAccToken("xxx");
req.setAuthParam(obj1);
RosefinchDingtalkSendRequest.DingTalkMsgDo obj2 = new RosefinchDingtalkSendRequest.DingTalkMsgDo();
RosefinchDingtalkSendRequest.TextMsg obj3 = new RosefinchDingtalkSendRequest.TextMsg();
obj3.setContent("xxx");
obj3.setIsAtAll(true);
obj3.setAtMobiles(""15924xxxxxx"");
obj2.setTextMsg(obj3);
RosefinchDingtalkSendRequest.LinkMsg obj4 = new RosefinchDingtalkSendRequest.LinkMsg();
obj4.setText("xxxx");
obj4.setPicUrl("http://img.alicdn.com/xxx.jpg");
obj4.setMessageUrl("http://www.taobao.com");
obj4.setTitle("xxxx");
obj2.setLinkMsg(obj4);
obj2.setWebhookAccessToken("xxxx");
req.setMsg(obj2);
RosefinchDingtalkSendResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<rosefinch_dingtalk_send_response>
    <result>
        <success>false</success>
        <code></code>
        <message></message>
        <value></value>
    </result>
</rosefinch_dingtalk_send_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

返回
顶部