C#如何实现调取钉钉考勤接口的功能
作者:努力尝试! 时间:2023-09-14 17:31:47
调取钉钉考勤接口的功能
公司需要做一个钉钉考勤的页面,让我去写这个功能。结果却比我想象的要麻烦一些!具体是怎么个麻烦呢
下面直入正题
首先我们找到获取钉钉考勤结果的接口。结果发现请求参数里有一个userIdList列表,那么这时候第一个问题就来了,如何获得这个userIdList呢?(注意这里的调用方式 是POST)
我们需要调用通讯录管理下的用户管理下的获取部门用户接口。来获得用户名字和用户的userId。那么这个时候 发现还需要另一个参数 部门id。那么部门id又是什么呢?(注意这里的调用方式 是GET)
我们找到了这个接口(通讯录管理下的部门管理下的获取部门列表),然后把id设置为空,就可以得到所有的部门列表了,在部门列表里找到自己部门的id即可。(注意这里的调用方式 是GET)
这样经过一波三折,总算调到了钉钉考勤的结果。注意,一次只能调取7天的哦!
当然,获取到结果之后,还需要进行对数据的分析处理等工作,经过了几天的努力我才完成。
PS:token的获得方法。
public static string GetAccess_Tocken()
{
var url = @"https://oapi.dingtalk.com/gettoken?appkey="+AppKey+"&appsecret="+AppSecret;
var result = Json.ToJObject(HttpMethods.HttpGet(url));
var tocken = result["access_token"]?.ToString();
return tocken;
}
小技巧:
我们可以通过在线调试快速获得部门id,快速验证接口能否使用。不过需要管理员才能使用在线调试这个功能。
调用钉钉接口发送图片群消息
前段时间我被一个需求困扰,如何调用钉钉接口发送图片消息?文字消息用string类型的参数很容易实现了,可是好像要发图片就灭有那么简单了,好在后来经过我的摸索,解决了问题。
步骤如下
要想发群消息,首先要建个钉钉群,建群的话首先要获取全局ID,要用到钉钉上的企业ID
? //全局群id
? ? ? public static ?string getchatid = "";//群会话id(系统停止之后消失)
? ? ? ? //用于判断是否换班成功(是否成功创建新群)
? ? ? public static ?Boolean flagid =false;?
? ? ? ? /// <summary>
? ? ? ? /// 获取接口全局ID
? ? ? ? /// </summary>
? ? ? ? /// <returns></returns>
? ? ? ? private string accessToken() {
? ? ? ? ? ? string corpid = "**************";
? ? ? ? ? ? string CorpSecret = "*******************************";
? ? ? ? ? ? string AccessToke = "";
? ? ? ? ? ? string url = string.Format("https://oapi.dingtalk.com/gettoken?appkey={0}&appsecret={1}", corpid, CorpSecret);
? ? ? ? ? ? JToken json = JToken.Parse(HttpUtiy.HttpGet(url));
? ? ? ? ? ? AccessToke = json["access_token"].ToString();
? ? ? ? ? ? return AccessToke;
? ? ? ? } ? ?
我们这次实现的功能是,通过群成员的手机号作为参数建群,所以要根据手机号获取用户的UserID
//根据手机号获取用户UserID ?
? ? ? ? private string UserID(string phone) {
? ? ? ? ? ? // 通过手机号获取 userId?
? ? ? ? ? ? string url = string.Format("https://oapi.dingtalk.com/user/get_by_mobile?access_token={0}&mobile={1}",accessToken(), phone);
? ? ? ? ? ? string userid ="找不到用户id";//用户企业内部id
? ? ? ? ? ? JToken json = JToken.Parse(HttpUtiy.HttpGet(url));
? ? ? ? ? ? if (json["errmsg"].ToString() != "找不到该用户") {
? ? ? ? ? ? ? ? ? userid = json["userid"].ToString();
? ? ? ? ? ? }
? ? ? ? ? ? return userid;
? ? ? ? }
下面可以建群了,以下代码是建群方法
?/// <summary>
? ? ? ? /// 创建群会话
? ? ? ? /// </summary>
? ? ? ? /// <param name="phone1">值班人员1手机号</param>
? ? ? ? /// <param name="phone2">值班人员1手机号</param>
? ? ? ? /// <param name="Chatidname">群名称</param>
? ? ? ? public void Creatchatid(string phone1, string phone2,string Chatidname
? ? ? ? ? ? ) {
? ? ? ? ? ?
? ? ? ? ? ? ? ? #region 获取用户企业内部id
? ? ? ? ? ? ? ? //获取值班人员企业userid
? ? ? ? ? ? ? ? string userid = UserID(phone1);//获取用户userId(第一个人作为群主)
? ? ? ? ? ? ? ? string userid2 = UserID(phone2);
? ? ? ? ? ? ? ? //用户id添加到,成员数组。
? ? ? ? ? ? ? ? string[] Chatiduseridlist = new string[] { userid, userid2 };//添加到群成员列表里
? ? ? ? ? ? ? ? #endregion
? ? ? ? ? ? ? ? //判断是否正确获得用户企业id
? ? ? ? ? ? ? ? if (userid.Trim() == "找不到用户id" || userid2.Trim() == "找不到用户id")
? ? ? ? ? ? ? ? {
? ? ? ? ? ? ? ? ? ? flagid = false;//获取用户id失败
? ? ? ? ? ? ? ? }
? ? ? ? ? ? ? ? else {
? ? ? ? ? ? ? ? ? ??
? ? ? ? ? ? ? ? ? ? #region 创建群会话
? ? ? ? ? ? ? ? ? ? string MessageUrl = string.Format("https://oapi.dingtalk.com/chat/create?access_token={0}", accessToken());
? ? ? ? ? ? ? ? ? ? var json_req = new
? ? ? ? ? ? ? ? ? ? {
? ? ? ? ? ? ? ? ? ? ? ? name = Chatidname, // 群名称
? ? ? ? ? ? ? ? ? ? ? ? owner = userid, ?// 群主id
? ? ? ? ? ? ? ? ? ? ? ? useridlist = Chatiduseridlist
? ? ? ? ? ? ? ? ? ? };
? ? ? ? ? ? ? ? ? ? string jsonRequest = JsonConvert.SerializeObject(json_req);//将对象转换为字符串类型
? ? ? ? ? ? ? ? ? ? JToken json = JToken.Parse(HttpUtiy.HttpPost(MessageUrl, jsonRequest));//返回值转换为JToken格式 ? ? ? ? ? ? ? ? ? ? ? ? ?//赋值给成员变量,避免多次创建群。
? ? ? ? ? ? ? ? ? ? getchatid = json["chatid"].ToString();
? ? ? ? ? ? ? ? ? ? #endregion
? ? ? ? ? ? ? ? ? ? //改变flagid标签状态
? ? ? ? ? ? ? ? ? ? flagid = true;
? ? ? ? ? ? ? ? } ? ? ? ? ? ? ??
? ? ? ? }
建好了群之后就可以发消息了,字符串消息很简单,像开头说的那样,代码如下
? ? ? ? /// <summary>
? ? ? ? /// 发送群消息
? ? ? ? /// </summary>
? ? ? ? public void SendMsg() {
? ? ? ? ? ? //发送群消息
? ? ? ? ? ? string MessageUrl =string.Format("https://oapi.dingtalk.com/chat/send?access_token={0}",accessToken());
? ? ? ? ? ? var json_req = new
? ? ? ? ? ? {
? ? ? ? ? ? ? ? chatid = getchatid,//获取群会话id
? ? ? ? ? ? ? ? ? ?msg=new {?
? ? ? ? ? ? ? ? ? ? ? ?msgtype="text",
? ? ? ? ? ? ? ? ? ? ? ?text = new {
? ? ? ? ? ? ? ? ? ? ? ? ? ?content = "有陌生人闯入,请及时查看!"
? ? ? ? ? ? ? ? ? ? ? ?} ? ??
? ? ? ? ? ? ? ? ?}
? ? ? ? ? ? };
? ? ? ? ? ? string jsonRequest = JsonConvert.SerializeObject(json_req);//将json转位字符串
? ? ? ? ? ? HttpUtiy.HttpPost(MessageUrl, jsonRequest);
? ? ? ? }
仿照同样的格式,写出了图片消息的方法
?//发送图片消息的方法
? ? ? ? public void SendMsgPic()
? ? ? ? {
? ? ? ? ? ? //发送群消息
? ? ? ? ? ? string MessageUrl = string.Format("https://oapi.dingtalk.com/chat/send?access_token={0}", accessToken());
? ? ? ? ? ? var json_req = new
? ? ? ? ? ? {
? ? ? ? ? ? ? ? chatid = getchatid,//获取群会话id
? ? ? ? ? ? ? ? msg = new
? ? ? ? ? ? ? ? {
? ? ? ? ? ? ? ? ? ? msgtype = "image",
? ? ? ? ? ? ? ? ? ? image = new
? ? ? ? ? ? ? ? ? ? {
? ? ? ? ? ? ? ? ? ? ? ? media_id = "图片的媒体ID"
? ? ? ? ? ? ? ? ? ? }
? ? ? ? ? ? ? ? }
? ? ? ? ? ? };
? ? ? ? ? ? string jsonRequest = JsonConvert.SerializeObject(json_req);//将json转位字符串
? ? ? ? ? ? HttpUtiy.HttpPost(MessageUrl, jsonRequest);
? ? ? ? }
来源:https://blog.csdn.net/weixin_43549003/article/details/108600338