概述

钉钉官方提供了统一的SDK,使用SDK可以便捷的调用服务端各API。注意:此SDK包含原有TOP接口,原有TOP接口可以继续正常调用,没有影响。下面是使用SDK调用API的请求示例:

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对应的,然后可获取执行结果