using System;
using System.Xml.Serialization;
using System.Collections.Generic;
using Top.Api.Util;
using Top.Api;
using Top.Api.DingTalk;
namespace DingTalk.Api.Request
{
///
/// TOP API: dingtalk.oapi.message.corpconversation.asyncsend_v2
///
public class OapiMessageCorpconversationAsyncsendV2Request : BaseDingTalkRequest
{
///
/// 微应用的id
///
public Nullable AgentId { get; set; }
///
/// 接收者的部门id列表
///
public string DeptIdList { get; set; }
///
/// 是否开启id转译,默认false。仅第三方应用需要用到,企业内部应用可以忽略
///
public Nullable EnableIdTrans { get; set; }
///
/// 消息体,具体见文档
///
public string Msg { get; set; }
public MsgDomain Msg_ { set { this.Msg = TopUtils.ObjectToJson(value); } }
///
/// 是否发送给企业全部用户
///
public Nullable ToAllUser { get; set; }
///
/// 接收者的用户userid列表
///
public string UseridList { get; set; }
#region IDingTalkRequest Members
public override string GetApiName()
{
return "dingtalk.oapi.message.corpconversation.asyncsend_v2";
}
public override string GetApiCallType()
{
return DingTalkConstants.CALL_TYPE_OAPI;
}
public override IDictionary GetParameters()
{
TopDictionary parameters = new TopDictionary();
parameters.Add("agent_id", this.AgentId);
parameters.Add("dept_id_list", this.DeptIdList);
parameters.Add("enable_id_trans", this.EnableIdTrans);
parameters.Add("msg", this.Msg);
parameters.Add("to_all_user", this.ToAllUser);
parameters.Add("userid_list", this.UseridList);
if (this.otherParams != null)
{
parameters.AddAll(this.otherParams);
}
return parameters;
}
public override void Validate()
{
RequestValidator.ValidateRequired("agent_id", this.AgentId);
RequestValidator.ValidateMaxListSize("dept_id_list", this.DeptIdList, 500);
RequestValidator.ValidateRequired("msg", this.Msg);
RequestValidator.ValidateMaxListSize("userid_list", this.UseridList, 5000);
}
///
/// TextDomain Data Structure.
///
[Serializable]
public class TextDomain : TopObject
{
///
/// 文本消息
///
[XmlElement("content")]
public string Content { get; set; }
}
///
/// ImageDomain Data Structure.
///
[Serializable]
public class ImageDomain : TopObject
{
///
/// 图片消息
///
[XmlElement("media_id")]
public string MediaId { get; set; }
}
///
/// LinkDomain Data Structure.
///
[Serializable]
public class LinkDomain : TopObject
{
///
/// 消息点击链接地址
///
[XmlElement("messageUrl")]
public string MessageUrl { get; set; }
///
/// 图片地址
///
[XmlElement("picUrl")]
public string PicUrl { get; set; }
///
/// 消息标题,建议100字符以内
///
[XmlElement("text")]
public string Text { get; set; }
///
/// 消息描述,建议500字符以内
///
[XmlElement("title")]
public string Title { get; set; }
}
///
/// FileDomain Data Structure.
///
[Serializable]
public class FileDomain : TopObject
{
///
/// 媒体文件id。引用的媒体文件最大10MB
///
[XmlElement("media_id")]
public string MediaId { get; set; }
}
///
/// VoiceDomain Data Structure.
///
[Serializable]
public class VoiceDomain : TopObject
{
///
/// 正整数,小于60,表示音频时长
///
[XmlElement("duration")]
public string Duration { get; set; }
///
/// 媒体文件id。2MB,播放长度不超过60s,AMR格式
///
[XmlElement("media_id")]
public string MediaId { get; set; }
}
///
/// RichDomain Data Structure.
///
[Serializable]
public class RichDomain : TopObject
{
///
/// 单行富文本信息的数目
///
[XmlElement("num")]
public string Num { get; set; }
///
/// 单行富文本信息的单位
///
[XmlElement("unit")]
public string Unit { get; set; }
}
///
/// FormDomain Data Structure.
///
[Serializable]
public class FormDomain : TopObject
{
///
/// 消息体的关键字
///
[XmlElement("key")]
public string Key { get; set; }
///
/// 消息体的关键字对应的值
///
[XmlElement("value")]
public string Value { get; set; }
}
///
/// BodyDomain Data Structure.
///
[Serializable]
public class BodyDomain : TopObject
{
///
/// 自定义的作者名字
///
[XmlElement("author")]
public string Author { get; set; }
///
/// 消息体的内容,最多显示3行
///
[XmlElement("content")]
public string Content { get; set; }
///
/// 自定义的附件数目。此数字仅供显示,钉钉不作验证
///
[XmlElement("file_count")]
public string FileCount { get; set; }
///
/// 消息体的表单,最多显示6个,超过会被隐藏
///
[XmlArray("form")]
[XmlArrayItem("form")]
public List Form { get; set; }
///
/// 消息体中的图片,支持图片资源@mediaId
///
[XmlElement("image")]
public string Image { get; set; }
///
/// 单行富文本信息
///
[XmlElement("rich")]
public RichDomain Rich { get; set; }
///
/// 消息体的标题,建议50个字符以内
///
[XmlElement("title")]
public string Title { get; set; }
}
///
/// HeadDomain Data Structure.
///
[Serializable]
public class HeadDomain : TopObject
{
///
/// 消息头部的背景颜色。长度限制为8个英文字符,其中前2为表示透明度,后6位表示颜色值。不要添加0x
///
[XmlElement("bgcolor")]
public string Bgcolor { get; set; }
///
/// 消息的头部标题 (向普通会话发送时有效,向企业会话发送时会被替换为微应用的名字),长度限制为最多10个字符
///
[XmlElement("text")]
public string Text { get; set; }
}
///
/// StatusBarDomain Data Structure.
///
[Serializable]
public class StatusBarDomain : TopObject
{
///
/// 状态栏背景色,默认为黑色
///
[XmlElement("status_bg")]
public string StatusBg { get; set; }
///
/// 状态栏文案
///
[XmlElement("status_value")]
public string StatusValue { get; set; }
}
///
/// OADomain Data Structure.
///
[Serializable]
public class OADomain : TopObject
{
///
/// 消息体
///
[XmlElement("body")]
public BodyDomain Body { get; set; }
///
/// 消息头部内容
///
[XmlElement("head")]
public HeadDomain Head { get; set; }
///
/// 消息点击链接地址,当发送消息为小程序时支持小程序跳转链接
///
[XmlElement("message_url")]
public string MessageUrl { get; set; }
///
/// PC端点击消息时跳转到的地址
///
[XmlElement("pc_message_url")]
public string PcMessageUrl { get; set; }
///
/// 状态栏
///
[XmlElement("status_bar")]
public StatusBarDomain StatusBar { get; set; }
}
///
/// MarkdownDomain Data Structure.
///
[Serializable]
public class MarkdownDomain : TopObject
{
///
/// markdown格式的消息,建议500字符以内
///
[XmlElement("text")]
public string Text { get; set; }
///
/// 首屏会话透出的展示内容
///
[XmlElement("title")]
public string Title { get; set; }
}
///
/// BtnJsonListDomain Data Structure.
///
[Serializable]
public class BtnJsonListDomain : TopObject
{
///
/// 消息点击链接地址,当发送消息为小程序时支持小程序跳转链接,最长500个字符
///
[XmlElement("action_url")]
public string ActionUrl { get; set; }
///
/// 使用独立跳转ActionCard样式时的按钮的标题,最长20个字符
///
[XmlElement("title")]
public string Title { get; set; }
}
///
/// ActionCardDomain Data Structure.
///
[Serializable]
public class ActionCardDomain : TopObject
{
///
/// 使用独立跳转ActionCard样式时的按钮列表;必须与btn_orientation同时设置
///
[XmlArray("btn_json_list")]
[XmlArrayItem("btn_json_list")]
public List BtnJsonList { get; set; }
///
/// 使用独立跳转ActionCard样式时的按钮排列方式,竖直排列(0),横向排列(1);必须与btn_json_list同时设置
///
[XmlElement("btn_orientation")]
public string BtnOrientation { get; set; }
///
/// 消息内容,支持markdown,语法参考标准markdown语法。建议1000个字符以内
///
[XmlElement("markdown")]
public string Markdown { get; set; }
///
/// 使用整体跳转ActionCard样式时的标题,必须与single_url同时设置,最长20个字符
///
[XmlElement("single_title")]
public string SingleTitle { get; set; }
///
/// 消息点击链接地址,当发送消息为小程序时支持小程序跳转链接,最长500个字符
///
[XmlElement("single_url")]
public string SingleUrl { get; set; }
///
/// 透出到会话列表和通知的文案,最长64个字符
///
[XmlElement("title")]
public string Title { get; set; }
}
///
/// MsgDomain Data Structure.
///
[Serializable]
public class MsgDomain : TopObject
{
///
/// 卡片消息
///
[XmlElement("action_card")]
public ActionCardDomain ActionCard { get; set; }
///
/// 文件消息
///
[XmlElement("file")]
public FileDomain File { get; set; }
///
/// 图片消息
///
[XmlElement("image")]
public ImageDomain Image { get; set; }
///
/// 链接消息
///
[XmlElement("link")]
public LinkDomain Link { get; set; }
///
/// markdown消息
///
[XmlElement("markdown")]
public MarkdownDomain Markdown { get; set; }
///
/// 消息类型
///
[XmlElement("msgtype")]
public string Msgtype { get; set; }
///
/// OA消息
///
[XmlElement("oa")]
public OADomain Oa { get; set; }
///
/// 文本消息
///
[XmlElement("text")]
public TextDomain Text { get; set; }
///
/// 语音消息
///
[XmlElement("voice")]
public VoiceDomain Voice { get; set; }
}
#endregion
}
}