本文是針對釘釘開放平台的基於dotNetCore服務端開發和配置的描述
釘釘可開發的程序包括 企業內部應用,第三方企業應用,第三方個人應用
一、環境搭建
1.釘釘開發需要企業釘釘賬號,如果學習測試環境的話可以自己注冊一個企業號。
2.根據需求創建程序。注意服務器出口IP,即Ip白名單,開發環境設定為本地Ip,生產環境則為服務器Ip。[如圖]
3.應用創建完成 得到 AgentId,AppKey,AppSecret
二、環境測試
1. SDK下載 項目引用SDK dll
2. 獲取部門測試是否成功 PS:(1)GetAccessToken方法為自定義獲取AccessToken的方法。(2)SvcResult為自定義的返回信息方法。
DefaultDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/department/list"); OapiDepartmentListRequest request = new OapiDepartmentListRequest { Id = "1" //默認第一級 }; request.SetHttpMethod("GET"); OapiDepartmentListResponse response = client.Execute(request, GetAccessToken()); if (response.Errcode != 0) { return SvcResult.Error($"{response.Errmsg}[{response.Errcode}]"); } if (!response.Department.Any()) { return SvcResult.Info("無數據"); } var re = response.Department.Select(e => new DDDepartmentInfoDTO() { AutoAddUser = e.AutoAddUser, CreateDeptGroup = e.CreateDeptGroup, Id = e.Id, Name = e.Name, Parentid = e.Parentid }).ToList(); return SvcResult.Success(re);
OK 測試成功,獲取到了當前企業釘釘的所有部門。
其他的請參考釘釘開放平台文檔