查询任务

请求方式：GET（HTTPS）

请求地址：https://lxapi.lexiangla.com/cgi-bin/v1/jobs/{job_id}?access_token={access_token}

参数说明：

参数	是否必须	默认值	说明
access_token	是	无	调用接口凭证
job_id	是	无	要查询的任务ID，只能查询72小时内创建的任务

返回结果：

{
    "code": 0,
    "msg": "ok",
    "status": 0,
    "data": {
        "download_url": "https://xxxxx"
    }
}

参数说明：

参数	说明
code	返回码
msg	对返回码的文本描述内容
status	任务状态，整型，0表示任务等待中，1表示任务进行中，2表示任务已完成
data	任务完成时，具体的响应数据
download_url	数据导出任务完成时，会响应该字段，用于下载统计数据的excel文件

download_url一般自当前查询任务响应时间起，5小时内有效，请获取到download_url后尽快下载

当接口为创建用户列表导出任务 和创建部门列表导出任务 时download_url下载表需要进行解密

PHP解密demo代码：

<?php
$aesKey = "today+yesterday+tomorrow+1234567"; // 32位
$content = file_get_contents("./成员导出.json");
if (!empty($content)) {
    $iv = substr($aesKey, 0, 16);
    $decrypted = \openssl_decrypt($content, 'AES-256-CBC', $aesKey, 0, $iv);
    echo $decrypted;    
}
?>

文件内容解密后的成员列表

[
    {
        "staff_id": "a1",
        "name": "小A",
        "gender": 0,
        "avatar": "",
        "departments": [
            128
        ]
    },
    {
        "staff_id": "b1",
        "name": "小B",
        "gender": 0,
        "avatar": "",
        "departments": [
            2
        ]
    }
]

文件内容解密后的部门列表

[
    {
        "id": 1,
        "name": "根部门",
        "parent_id": 0,
        "path": "/1",
        "order": 2147483447
    },
    {
        "id": 2,
        "name": "二级部门",
        "parent_id": 1,
        "path": "/1/2",
        "order": 2147484247
    }
]

文件内容加密说明

文件内容加密是参考企业微信 (opens new window)。加密不仅仅是为了解决网络传输过程被窃取（因为本来就是https），也是防止调用方拉取文件后，使用完毕没有及时清理，存储于云端等，若没有加密，容易造成通讯录敏感信息泄漏。

建议调用方使用固定的32位字符串，不需要每次请求生成新的。进行base64加密后，得到44位长度的字符串，去掉最后的“=”字符得到43位，则可以作为encoding_aeskey参数值。