DtJava - DingTalk Java SDK

钉钉Java SDK

License

License

Categories

Categories

Java Languages
GroupId

GroupId

com.github.tingyugetc520
ArtifactId

ArtifactId

dt-java
Last Version

Last Version

0.1.2
Release Date

Release Date

Type

Type

jar
Description

Description

DtJava - DingTalk Java SDK
钉钉Java SDK
Project URL

Project URL

https://github.com/tingyugetc520/DtJava
Source Code Management

Source Code Management

https://github.com/tingyugetc520/DtJava

Download dt-java

How to add to project

<!-- https://jarcasting.com/artifacts/com.github.tingyugetc520/dt-java/ -->
<dependency>
    <groupId>com.github.tingyugetc520</groupId>
    <artifactId>dt-java</artifactId>
    <version>0.1.2</version>
</dependency>
// https://jarcasting.com/artifacts/com.github.tingyugetc520/dt-java/
implementation 'com.github.tingyugetc520:dt-java:0.1.2'
// https://jarcasting.com/artifacts/com.github.tingyugetc520/dt-java/
implementation ("com.github.tingyugetc520:dt-java:0.1.2")
'com.github.tingyugetc520:dt-java:jar:0.1.2'
<dependency org="com.github.tingyugetc520" name="dt-java" rev="0.1.2">
  <artifact name="dt-java" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.github.tingyugetc520', module='dt-java', version='0.1.2')
)
libraryDependencies += "com.github.tingyugetc520" % "dt-java" % "0.1.2"
[com.github.tingyugetc520/dt-java "0.1.2"]

Dependencies

compile (11)

Group / Artifact Type Version
com.squareup.okhttp3 : okhttp jar 4.5.0
org.apache.httpcomponents : httpclient jar 4.5
org.apache.httpcomponents : httpmime jar 4.5
commons-codec : commons-codec jar 1.10
commons-io : commons-io jar 2.5
org.apache.commons : commons-lang3 jar 3.10
org.apache.commons : commons-collections4 jar 4.4
org.slf4j : slf4j-api jar 1.7.30
com.thoughtworks.xstream : xstream jar 1.4.15
com.google.guava : guava jar 29.0-jre
com.google.code.gson : gson jar 2.8.0

provided (5)

Group / Artifact Type Version
org.jodd : jodd-http jar 5.2.0
redis.clients : jedis jar 3.3.0
com.github.jedis-lock : jedis-lock jar 1.0.0
org.redisson : redisson Optional jar 3.12.0
org.projectlombok : lombok jar 1.18.8

test (9)

Group / Artifact Type Version
joda-time : joda-time jar 2.10.6
ch.qos.logback : logback-classic jar 1.2.3
com.google.inject : guice jar 4.2.3
org.testng : testng jar 7.1.0
org.mockito : mockito-all jar 1.10.19
org.eclipse.jetty : jetty-server jar 9.4.35.v20201120
org.eclipse.jetty : jetty-servlet jar 9.4.35.v20201120
org.assertj : assertj-guava jar 3.0.0
com.github.dreamhead : moco-runner jar 1.1.0

Project Modules

There are no modules declared in this project.

DtJava

介绍

DtJava(DingTalk Java SDK-钉钉SDK) 封装了钉钉凭证、通讯录管理、消息通知等服务端接口,让开发者可以使用简单的配置,提供简洁的 API 以供方便快速地调用钉钉接口。

注意:目前SDK主要是以企业内建应用为主,ISV应用后面会陆续支持。

文档

查看wiki首页

Demo示例可 查看DEMO项目 ,包括事件消息回调处理等等。

安装

  • 通过Maven方式安装使用
<dependency>
    <groupId>com.github.tingyugetc520</groupId>
    <artifactId>dt-java</artifactId>
    <version>0.1.2</version>
</dependency>

目前已发布0.1.2版本

  • 直接下载源码使用
git clone https://github.com/tingyugetc520/DtJava.git

源码下载完成后,放置在您的项目中使用,同时请注意相关依赖的问题。

使用

可前往查看DEMO项目

// 钉钉应用配置
DtDefaultConfigImpl config = new DtDefaultConfigImpl();
config.setCorpId("corpId");
config.setAgentId(agentId);
config.setAppKey("appKey");
config.setAppSecret("appSecret");

// DtService为SDK使用入口,后续接口使用均需要DtService
DtServiceImpl dtService = new DtServiceImpl();
dtService.setDtConfigStorage(config);

// 查询用户
DtUser user = dtService.getUserService().getById(userId);
log.info("dt user:{}", user);

// 发送工作消息通知
DtCorpConversationMessage message = DtCorpConversationMessage.builder()
			.agentId(config.getAgentId())
			.userIds(Lists.newArrayList("userId"))
			.msg(DtMessage.TEXT().content("this is content").build())
			.build();
dtService.getCorpConversationMsgService().send(message);

更多的示例可 查看DEMO项目 ,包括事件消息回调处理等等。

封装进度(企业内建应用)

  • HTTP代理,支持正向代理与反向代理
  • 获取凭证
  • 身份验证
  • 通讯录管理(只读)
  • 消息通知-工作消息通知
  • HTTP事件回调

Versions

Version
0.1.2
0.1.1
0.1.0