首页 > 代码库 > 钉钉开发平台服务端笔记

钉钉开发平台服务端笔记

钉钉开发平台服务端练习:
1.在钉钉开发者平台创建一个微应用(前提是注册);
2.将编写好的项目放在钉钉微应用中,建立两者的连接。
把开发的项目的首页地址,和后台地址,给我们的微应用。地址必须是http://打头的公网地址。
或者说是把工程放到一台服务器中,对外进行访问。
3.然后根据服务端开发文档创建微应用的各个功能。如:部门操作;员工操作等。

如何接入?
首先要有公司的CorpID企业标识和CorpSecret企业凭证密钥,然后再获取访问令牌accessToken。

public static final String CORP_ID = "ding40190c488873bf8435c2f4657eb6378f";

public static final String CORP_SECRET = "c8tQukQ0-        

QzCTpXtZ94EXmn2gDMNtfWTH_n4b3q9uiCILvT6f4mXcbk-zT34tbu2";

public static final String SSO_Secret =     

"GSVcAMrlI59orPi78JXVJzhjywehtkZ6cKviI2myUXIfC259CptrpH55Gjk8NnXi";


获得accessToken
ServiceFactory serviceFactory = ServiceFactory.getInstance();
 CorpConnectionService corpConnectionService = serviceFactory.getOpenService

(CorpConnectionService.class);
 accToken = corpConnectionService.getCorpToken(Env.CORP_ID, Env.CORP_SECRET);


获取微应用后台管理免登SsoToken
public static String getSsoToken() throws OApiException {
        String url = "https://oapi.dingtalk.com/sso/gettoken?corpid=" + Env.CORP_ID +

"&corpsecret=" + Env.SSO_Secret;
        JSONObject response = HttpHelper.httpGet(url);
        String ssoToken;
        if (response.containsKey("access_token")) {
            ssoToken = response.getString("access_token");
        } else {
            throw new OApiResultException("Sso_token");
        }
        return ssoToken;
}

DepartmentHelper类:即部门管理类
1.创建部门createDepartment方法
参数:String accessToken, 访问令牌
 String name, 部门名称            
String parentId,父部门编号
String order,
boolean createDeptGroup //是否创建部门分组

2.部门列表listDepartments类
参数:String accessToken, 访问令牌
String parentDeptId 某个部门下的所有部门

3.删除部门deleteDepartment类
参数String accessToken, 访问令牌
Long id//要删除的部门编号

4.更新部门信息updateDepartment
参数:
String accessToken,访问令牌
long id,部门编号
String name,部门名称             
String parentId, 父部门id,根部门为1
String order, 在父部门中的次序值
Boolean createDeptGroup,是否新创建部门分组    
boolean autoAddUser, 当群已经创建后,是否有新人加入部门会自动加入该群, true表示是, false表示不是
String deptManagerUseridList, 部门管理的用户列表
boolean deptHiding, 是否隐藏部门, true表示隐藏, false表示显示
String deptPerimits,可以查看指定隐藏部门的其他部门列表,如果部门隐藏,则此值生效,取值为其他的部门id组

成的的字符串,使用|符号进行分割
String userPerimits, 可以查看指定隐藏部门的其他人员列表,如果部门隐藏,则此值生效,取值为其他的人员

userid组成的的字符串,使用|符号进行分割
Boolean outerDept, 是否本部门的员工仅可见员工自己, 为true时,本部门员工默认只能看到员工自己
String outerPermitDepts,本部门的员工仅可见员工自己为true时,可以配置额外可见部门,值为部门id组成的的字

符串,使用|符号进行分割    
String outerPermitUsers, 本部门的员工仅可见员工自己为true时,可以配置额外可见人员,值为userid组成的用|

符号进行分割
String orgDeptOwner企业群群主

部门类里的所有方法都会有一个accessToken调用接口凭证。

未完待续.......

钉钉开发平台服务端笔记