釘釘開發平台服務端筆記

釘釘開發平台服務端練習：
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調用接口憑證。

未完待續.......