契约锁 API

组织架构-员工列表

GET

/v2/employee/list

获取员工列表。

请求参数

Query 参数

selectOffset

integer

可选

查询起始位置，默认为0

示例值:

selectLimit

integer

可选

查询列表大小，默认1000

示例值:

tenantName

string

可选

查询条件：子公司名称，若传递了则查询子公司下的员工

role

string

可选

查询条件：员工角色，SYSTEM_ADMIN（“系统管理员”）、SEAL_ADMIN（“印章管理员”）、TEMPLATE_ADMIN（“模板管理员”）

Header 参数

x-qys-open-accesstoken

string

可选

默认值:

x-qys-open-timestamp

string

可选

默认值:

x-qys-open-nonce

string

可选

默认值:

x-qys-open-signature

string

可选

默认值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://openapi.qiyuesuo.com/v2/employee/list' \
--header 'x-qys-open-accesstoken: {{x-qys-open-accesstoken}}' \
--header 'x-qys-open-timestamp: {{x-qys-open-timestamp}}' \
--header 'x-qys-open-nonce: {{x-qys-open-nonce}}' \
--header 'x-qys-open-signature: {{x-qys-open-signature}}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

result

object

必需

totalCount

string

员工数量

必需

list

array [object {7}]

员工列表

必需

示例

{
  "result": {
    "list": [
      {
        "id": "3053234808319771170",
        "name": "乔杰",
        "createTime": "2023-01-18 15:45:05",
        "mobile": "11088315232",
        "realName": false,
        "departmentNames": "思晨教育"
      },
      {
        "id": "3053234620050047514",
        "name": "孔平",
        "createTime": "2023-01-18 15:44:20",
        "mobile": "11062163690",
        "realName": false,
        "departmentNames": "思晨教育"
      }
    ],
    "totalCount": "323"
  },
  "code": 0,
  "message": "SUCCESS"
}

组织架构-获取企业信息变更链接

组织架构-添加员工