C#实现企业应用接入钉钉

本文属于个人原创作品、个人总结，谢绝转载、抄袭。如果您有疑问或者希望沟通交流，可以联系QQ：865562060。

一、开始接入

1、开始接入钉钉之前，首先需要了解企业接入钉钉的概述：https://open-doc.dingtalk.com/microapp/bgb96b/klan6s

2、了解完成之后，就需要注册钉钉企业并登陆钉钉企业后台。然后就关键的一步就是获取appKey和appSecrethttps://ding-doc.dingtalk.com/doc#/serverapi2/eev437，或者获取企业级的CorpID和CorpSecret。这两者都可以用来获取钉钉的access_token。

3、如果需要将公司内部系统的组织架构、人员信息、角色管理、考勤管理、签到、审批等接入钉钉，可以通过浏览钉钉的开发者文档了解详细的信息：https://ding-doc.dingtalk.com/doc#/serverapi2/cqfmel

4、在企业接入钉钉之后，还可以在企业工作台创建微应用，并可以在人员账户接入钉钉之后，实现企业应用的免登：

https://ding-doc.dingtalk.com/doc#/serverapi2/clotub

5、另外，钉钉的接入工作还有很多，我这里有一个集合体的github项目：https://github.com/Menyoupingxiaoguo/DDHelper，供大家参考。以下文档的代码均可以在此项目中找到，如果对大家有帮助，请点给项目点个star！

6、钉钉RC版（下载钉钉RC版之后和钉钉一样登录，在点击工作台应用之后，浏览器输入http://localhost:16888/即可对工作台应用进行调试，是调试工作台应用的非常不错的工具）。

二、代码实现

1、获取AccessToken。AccessToken是通过企业CorpID和CorpSecret、appKey和appSecret或者换取的接入钉钉的凭证，基本所有的钉钉接口都需要AccessToken，所以第一步就是获取AccessToken。钉钉为AccessToken提供的有效时长为7200s，在有效时间内每次请求都将自动延时，而钉钉提的要求是不允许对AccessToken进行高频率请求。所以我们可以采用缓存的方式，将AccessToken缓存起来，缓存时间少于7200s，即可在每次失效前再次延长。

public string dd_host = ConfigurationManager.AppSettings["DDHost"];
public string dd_corpid = ConfigurationManager.AppSettings["DD_corpid"];
public string dd_corpsecret = ConfigurationManager.AppSettings["DD_corpsecret"];
public string appkey = ConfigurationManager.AppSettings["appkey"];
public string appsecret = ConfigurationManager.AppSettings["appsecret"];/// <summary>
/// 获取AccessToken
/// </summary>
public string GetAccessToken()
{//从缓存中获取Token,如果缓存中已经过期，再从接口获取;object DDToken = CacheHelper.GetCache("dd_accesstoken");if (DDToken == null){//获取tokenIDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/gettoken");OapiGettokenRequest request = new OapiGettokenRequest();request.Corpid = dd_corpid;request.Corpsecret = dd_corpsecret;request.SetHttpMethod("GET");OapiGettokenResponse response = client.Execute(request);if(response.Errcode == 0)//将Token存入缓存CacheHelper.AddCache("dd_accesstoken", response.AccessToken, 115);}elsereturn DDToken.ToString();return "";
}
/// <summary>
/// 获取AccessToken
/// </summary>
public string GetAccessTokenByApp()
{//从缓存中获取Token,如果缓存中已经过期，再从接口获取;object DDToken = CacheHelper.GetCache("dd_app_accesstoken");if (DDToken == null){//获取tokenIDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/gettoken");OapiGettokenRequest request = new OapiGettokenRequest();request.Appkey = appkey;request.Appsecret = appsecret;request.SetHttpMethod("GET");OapiGettokenResponse response = client.Execute(request);if (response.Errcode == 0)//将Token存入缓存CacheHelper.AddCache("dd_app_accesstoken", JsonConvert.SerializeObject(response), 115);}elsereturn DDToken.ToString();return "";
}

2、接口示例。

因接入信息接口相对复杂且独特性太强，这里使用获取部门列表接口作为示例。

/// <summary>
/// 获取部门列表
/// </summary>
/// <param name="token"></param>
/// <param name="id">父部门id（如果不传，默认部门为根部门，根部门ID为1）</param>
/// <param name="fetch_child">是否递归部门的全部子部门，ISV微应用固定传递false</param>
/// <returns></returns>
public OapiDepartmentListResponse GetDeptList(string token, string id = "1", bool fetch_child = true)
{IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/department/list");OapiDepartmentListRequest request = new OapiDepartmentListRequest();request.Id = id;request.SetHttpMethod("GET");OapiDepartmentListResponse response = client.Execute(request, token);return response;/*{"errcode": 0,"errmsg": "ok","department": [{"id": 2,"name": "xxx","parentid": 1,"createDeptGroup": true,"autoAddUser": true},{"id": 3,"name": "服务端开发组","parentid": 2,"createDeptGroup": false,"autoAddUser": false}]} */
}

三、总结

钉钉的接入相对微信接入，个人认为是要简单许多，而且文档清晰、demo参考性强、SDK也比较多。