现在钉钉在企业内部的应用广泛。但实际情况，企业自身存在着很多老的系统，很多数据通知传递更多是通过邮件或者原始的QQ口头告知。有了钉钉，我们可以把企业内部的通知信息，通过钉钉来发送。这样就可以把整个业务系统完整的进行串联起来。
平时工作忙，自己也喜欢开发。所以总是琢磨怎么整合。万事开头难，.net应用钉钉开发资料不多，应用http://vb.net开发更是少。
现在开发需要，正好有时间整理下，分享下，就当是抛砖引玉。
1。了解钉钉的API消息接口应用
利用钉钉提供的API可以推送消息到用户的钉钉app。根据钉钉的官方文档，调用钉钉的api需要一个AccessToken，我们先获取这个AccessToken。
1.1、创建应用
用户进入钉钉开发平台。
创建应用，输入基本的应用信息。
创建完毕后，可以看到下图：
点击【企业信息推送】，如图
点击查看详细信息
目的是获取appkey,appsecret
另外还要设置下服务器公网出口IP名单，否则会出现内部消息无法推送的问题
1.2、接口权限限制
需要把通讯录都授权开放，否则影响数据读取。
2、App.config配置操作，主要是把之前应用的appkey,appsercet提取放在配置文件，方便读取
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<appSettings>
<add key="CorpID" value="abcd"/>
<add key="corpSecret" value="2222"/>
</appSettings>
<startup><supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/></startup></configuration>
实际开发中还用到http://json.net，这个需要通过NUGET,进行下载安装，选择Newtonsoft.Json
核心的关键是通过钉钉提供的接口，提取到access_token.下列是我写的部分类库，截取。
ImportsSystem.IOImportsSystem.NetImportsSystem.TextImportsNewtonsoft.Json''' <summary>''' 钉钉相关操作类库''' </summary>PublicClassddSdk''' <summary>''' 对应钉钉应用的AppKey''' </summary>''' <returns></returns>PublicPropertyCorpIdAsString''' <summary>''' 对应钉钉应用的AppSecret''' </summary>''' <returns></returns>PublicPropertyCorpSecretAsString''' <summary>''' 错误信息''' </summary>''' <returns></returns>PublicPropertyErrorInfoAsStringPublicPropertyAccessTokenAsAccessTokenPublicSubNew()EndSub''' <summary>''' 获取access_token信息，获取成功返回1，失败返回-2，并输出错误信息''' </summary>''' <returns></returns>PublicFunctionGetAccessToken()AsIntegerDimintsucAsInteger=-2TryDimstrCorpidAsString=CorpIdDimstrcorpSecretAsString=CorpSecretIfLen(strCorpid)=0Then'如果系统未提供，则从配置表中读取strCorpid=AppConfigInfo.CorpId()strcorpSecret=AppConfigInfo.CorpSecret()EndIfdimapiurlAsString=String.Format("https://oapi.dingtalk.com/gettoken?appkey={0}&appsecret={1}",strCorpid,strcorpSecret)DimrequestAsWebRequest=WebRequest.Create(apiurl)'发出url指令dimresponseAsWebResponse=request.GetResponse()'发送指令后，返回反馈信息dimstreamasStream=response.GetResponseStream()'反馈回来信息，中获取数据流Dimencodeasencoding=encoding.UTF8'字符格式dimreaderasStreamReader=NewStreamReader(stream,encode)'数据流以某种字符方式读取DimresultJsonasString=reader.ReadToEnd()’从头到尾数据流读取DimtokenResultAsTokenResult=JsonConvert.DeserializeObject(OfTokenResult)(resultJson)IftokenResult.ErrCode=ErrCodeEnum.OKThenAccessToken.Value=tokenResult.Access_tokenAccessToken.StartTime=Nowintsuc=1ElseErrorInfo=String.Format("错误代码:{0},错误信息:{1}",tokenResult.ErrCode,tokenResult.ErrMsg)EndIfCatchexAsExceptionErrorInfo=ex.MessageEndTryReturnintsucEndFunctionEndClass''' <summary>''' 错误代码''' </summary>PublicEnumErrCodeEnumOK=0VoildAccessToken=40014Unknown=Integer.MaxValueEndEnum
2.2.有了AccessToken，我们就可以调用钉钉的api了，发送推送的相关api在，文档已经写得很清晰了，我们只需要发送一个json格式的数据过去，就可以推送数据了。
Private Shared Function HttpPost(ByVal url As String, ByVal data As String) As String
Dim httpWebRequest As HttpWebRequest = CType(HttpWebRequest.Create(url), HttpWebRequest)
Dim bs As Byte() = Encoding.UTF8.GetBytes(data)
httpWebRequest.ContentType = "application/json"
httpWebRequest.ContentLength = bs.Length
httpWebRequest.Method = "POST"
httpWebRequest.Timeout = 20000
httpWebRequest.GetRequestStream().Write(bs, 0, bs.Length)
Dim httpWebResponse As HttpWebResponse = CType(httpWebRequest.GetResponse(), HttpWebResponse)
Dim streamReader As StreamReader = New StreamReader(httpWebResponse.GetResponseStream(), Encoding.UTF8)
Dim responseContent As String = streamReader.ReadToEnd()
streamReader.Close()
httpWebResponse.Close()
httpWebRequest.Abort()
Return responseContent
End Function
我在github上放了link.ddsdk接口类库，另外做了一个demo进行测试。有喜欢的可以去下载，顺便点个赞
网友评论