禅道提供了API机制方便于大家和其他的系统进行集成，API机制也都是基于http协议的，返回的数据以json格式存储。禅道的API都是需要先登录后才能进行接口调用（登录返回的cookie需要在之后的每次请求中携带用于验证身份信息）。网上关于禅道API调用机制的说明相对较少，接下来我会从postman调用和Java代码两种方式来体现禅道整个登录过程

注意：个别信息模糊展示比较私密不便于公开，请见谅！！

目录

流程图

获取session

登录-验证用户身份

获取cookie

参考代码--doGet（）

---

流程图

获取session

首先调用禅道提供的获取SessionID的API

postman：

接口返回的data中的sessionID对应的value值就是我们需要获取的sessionID值，用于后续禅道登录验证

Java代码：

//调用禅道接口获取sessionID
String session = doGet("http://127.0.0.1/zentao/api-getSessionID.json", null, false);

// json解析器-GSON
JsonParser parse = new JsonParser();

//将接口返回的字符串解析成json格式
JsonObject jsonSession = (JsonObject) parse.parse(session);

//将json格式中的data解析出来
JsonObject jsonObj = (JsonObject) parse.parse(jsonSession.get("data").getAsJsonPrimitive().getAsString());

//获取key为sessionID的值
String sessionID = jsonObj.get("sessionID").toString();

登录-验证用户身份

现在我们就可以使用sessionID来用户身份验证进行登录了，登录的时候需要提供用户名和密码，变量名如下：account，password

postman：

将上一步获取到的sessionID放到url地址中，在Params以key、value的形式放置登陆的用户名和密码

Java代码：

//存储登录需要使用到的信息
Map map = new HashMap();
//账号
map.put("account", "admin");
//密码
map.put("password", "A@789dmin");
//sessionID
map.put("zentaosid", sessionID);

//登录url
String loginResult = doGet("http://zentao.dmsd" +".tech//zentao/user-login-XXXX=.json", map, true);

获取cookie

登录成功之后我们把登录返回的cookie获取出来，用于调用其他API的携带信息了

说明：在解析响应体信息时，

postman：

在上一步登录之后返回的Cookie中包含了名为【zentaosid】的key、value，其中zentaosid为cookie名，相应的value为值，我们只需要获取出来便可以进行其他API的调用了

Java代码：

/**
* 用来存取cookies信息的变量.
*/
private static CookieStore cookieStore;


//获取登录过后的cookie 存入 cookieStore对象
public static String GetCookies(HttpGet get) throws IOException {
        String result = null;
        try {
            if (null == cookieStore) {
                cookieStore = new BasicCookieStore();
            }
            //获取响应
            CloseableHttpClient httpClient = HttpClients.custom().setDefaultCookieStore(cookieStore).build();
            //执行请求
            CloseableHttpResponse response = httpClient.execute(get);
            result = EntityUtils.toString(response.getEntity(), "utf-8");
            // 获取cookies信息
            List<Cookie> cookies = cookieStore.getCookies();
            //解析出zentaosid
            for (Cookie cookie : cookies) {
                String name = cookie.getName();
                String value = cookie.getValue();
                if (name.equals("zentaosid")) {
                    Constant.ZENTAOID = value;
                }
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
        return result;
}

参考代码--doGet（）

作用：执行url请求调用

//向指定url发起请求，可携带参数，并选择是否携带cookie
    public static String doGet(String url, Map params, boolean isCookie) {
        //获取httpclient客户端
        CloseableHttpClient httpclient = HttpClients.createDefault();
        String resultString = "";
        CloseableHttpResponse response = null;
        try {
            URIBuilder builder = new URIBuilder(url);
            if (null != params) {
                for (Object key : params.keySet()) {
                    String keyStr = key.toString();
                    String result = params.get(key).toString();
                    builder.setParameter(keyStr, result);
                }
            }

            //Get请求
            HttpGet get = new HttpGet(builder.build());
            //判断是否需要传入cookie
            //是：调用GetCookies（）方法获取cookie
            //否：执行请求
            if (!isCookie) {
                //执行请求
                response = httpclient.execute(get);
                //200表示接口调用成功
                if (200 == response.getStatusLine().getStatusCode()) {
                    //HttpEntity表示http的request和resposne实体，它由消息头和消息体组成。
                    //从HttpEntity中可以获取http请求头和回应头，也可以获取http请求体和回应体信息。
                    HttpEntity entity = response.getEntity();
                    resultString = EntityUtils.toString(entity, "utf-8");
                }
            } else {
                //调用GetCookies（）方法获取cookie
                resultString = GetCookies(get);
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (null != response) {
                try {
                    response.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }

            if (null != httpclient) {
                try {
                    httpclient.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }
        return resultString;
    }

参考链接：zentaoPHP二次开发简介 - zentaoPHP二次开发 - 易软天创开发者中心