上传者: yuyuncheng
|
上传时间: 2021-10-15 13:25:12
|
文件大小: 2.66MB
|
文件类型: -
钉钉 Java SDK
钉钉官方提供了统一的SDK,使用SDK可以便捷的调用服务端API。注意:此SDK包含原有TOP接口,原有TOP接口可以继续正常调用,没有影响。下面是使用SDK调用API的请求示例:
JAVA:
DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/user/get");
OapiUserGetRequest req = new OapiUserGetRequest();
req.setUserid("userid1");
req.setHttpMethod("GET");
OapiUserGetResponse rsp = client.execute(req, accessToken);
请求示例说明:
(1)定义Client对象,设置接口地址URI。一般地,无需拼接URL后面的参数,比如access_token;需要注意部分Post接口,需要在URI后拼接除access_token外的个别参数。
(2)构造Request对象,接口对应的request对象,一般规则是Oapi+接口Path驼峰形式+Request,如/user/get接口,请求对象是OapiUserGetRequest。
(3)调用Request的方法设置参数,注意参数HttpMethod,默认是POST,如果是GET类型接口,需要这样设置request.setHttpMethod("GET")。
(4)调用client.execute执行,其中access_token同样可以使用SDK获取到。同时,/gettoken,/sns/gettoken,
/service/get_suite_token等获取token的接口在调用execute时,无需再传token参数。
(5)执行后得到Response对象,是与Request对应的,然后可获取执行结果。
环境依赖
(1)JAVA SDK 需要依赖 Java SE/EE 1.5及以上。
(2).NET SDK 需要依赖 .NET Framework 2.0及以上 (不支持Windows Phone平台)。
(3)Python SDK需要依赖python2