服务端API



获取用户组列表

请求方式:GET(HTTPS)
请求地址:https://oapi.soke.cn/oa/group/list
Query参数说明:

参数 类型 必须 说明
access_token String 是 应用access_token,2小时有效期
start_time Int 是 课程创建时间的查询起始时间,Unix时间戳,单位毫秒
end_time Int 是 课程创建时间的查询结束时间,Unix时间戳,单位毫秒
page Int 否 页码,默认从1开始
page_size Int 否 每页条数,最大100,默认100

返回结果:

{
  "code": "200",
  "status": "ok",
  "message": "获取列表成功",
  "data": {
    "list": [{
   			"uuid": "AEA5676E-EF10-470C-BEE8-2C0CB3FB8039",
            "parent_id": "1",
            "name": "用户组api接口测试",
            "member_count": 0,
            "create_time": "2021-05-19 14:17:26"
    }],
	"has_more": 1
  }
}

参数说明:

参数 类型 说明
data Array 返回的数据包
list Array 返回的用户列表
uuid String 课程唯一ID,最大长度36字符
parent_id String 父id
name String 用户组标题
member_count Int 用户组人员总数
create_time Int 创建时间,Unix时间戳,单位毫秒
has_more Int 是否还有数据没返回:
- 1 还有
- 0 没有



获取用户组里用户列表

请求方式:GET(HTTPS)
请求地址:https://oapi.soke.cn/oa/group/userList
Query参数说明:

参数 类型 必须 说明
access_token String 是 应用access_token,2小时有效期
group_id String 是 用户组组唯一id,通过用户组列表获取
page Int 否 页码,默认从1开始
page_size Int 否 每页条数,最大100,默认100

返回结果:

{
  "code": "200",
  "status": "ok",
  "message": "获取列表成功",
  "data": {
    "list": [{
   			  "group_id": "AEA5676E-EF10-470C-BEE8-2C0CB3FB8111",
              "user_id": "14411105121212121",
              "user_name": "陈王某某",
              "create_time": "2021-05-19 16:05:44"
    }],
	"has_more": 1
  }
}

参数说明:

参数 类型 说明
data Array 返回的数据包
list Array 返回的用户列表
group_id String 用户组唯一ID
user_id String 用户钉钉内userid
user_name String 用户钉钉内name
create_time Int 创建时间,Unix时间戳,单位毫秒
has_more Int 是否还有数据没返回:
- 1 还有
- 0 没有