钉钉开发平台服务端笔记

Posted 2020-09-19 举林会天下

钉钉开发平台服务端练习：
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调用接口凭证。

未完待续.......