jdy
  1. guest
jdy
  • 开发指南
  • app
    • 用户应用查询接口
      POST
    • 用户表单查询接口
      POST
  • formdata
    • form
      • 表单字段查询接口V5
    • data
      • 查询单条数据接口
      • 查询多条数据接口
      • 新建单条数据接口
      • 新建多条数据接口
      • 修改单条数据接口
      • 修改多条数据接口
      • 删除单条数据接口
      • 删除多条数据接口
  • file
    • 获取文件上传凭证和上传地址接口
      POST
    • 文件上传接口
      POST
  • corp
    • user
      • 获取成员信息接口
      • 添加成员接口
      • 修改成员接口
      • 删除成员接口
      • 批量删除成员接口
      • 增量导入成员接口
    • department
      • (递归)获取部门成员接口
      • (递归)获取部门列表接口
      • 创建部门接口
      • 修改部门接口
      • 删除部门接口
      • 获取集成模式部门编号接口
      • 全量导入部门接口
    • role
      • 列出角色接口
      • 创建一个自建角色
      • 更新一个自建角色
      • 删除一个自建角色
      • 列出角色下的成员
      • 为自建角色批量添加成员
      • 为自建角色批量移除成员
    • role_group
      • 列出自建角色组
      • 创建自建角色组
      • 更新自建角色组
      • 删除自建角色组
    • guest
      • 列出我连接的企业
        POST
      • 列出我连接的企业的对接人
        POST
      • 获取我连接的企业对接人的详细信息
        POST
  • workflow
    • 获取单条流程表单数据的审批意见
      POST
    • 查询流程实例信息
      POST
    • 结束流程实例
      POST
    • 流程待办查询
      POST
    • 流程待办提交
      POST
    • 流程待办回退
      POST
    • 流程待办转交
      POST
    • 查询流程日志
      POST
    • 激活流程实例
      POST
  1. guest

列出我连接的企业的对接人

POST
/v5/corp/guest/user/list

列出我连接的企业的对接人#

能够获取 外部对接人 的列表部列出来。支持公共模式和集成模式。
接口版本:
接口版本更新时间版本说明
v42022.4.21初始版本:成员使用 username部门使用 dept_no包含 type 字段
V42022.6.30返回值新增字段 status
v52022.10.28在 v4 的基础上,接口请求频率由 5 次/秒提升至 30 次/秒;接口路由修改为 POST corp/guest/member_list
请求地址:https://api.jiandaoyun.com/api/v5/corp/guest/user/list
请求频率:30 次/秒
请求方式:POST
请求参数:
参数类型是否必需说明
dept_noInteger否部门编号,不填则返回全部
请求示例:
{
    "dept_no":19
}
响应内容:
参数类型是否必需说明
member_listArray是企业对接人内容数组
namestring是昵称
usernameString是用户名
departmentsArray[integer]是部门编号
typeNumber是部门类型0: 常规部2: 企业互联外部部门
statusNumber是部门状态:1: 使用中的部门-1: 集成模式下同步后删除的部门
integrate_idString否集成模式同步部门关联 ID
响应示例:
{
  "member_list": [
    {
      "name": "Purl",
      "username": "R-ww9a61c11fc226842f-#admin",
      "departments": [
        19
      ],
      "type": 2,
      "status": 1
    }
  ]
}

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json
dept_no
integer 
必需
示例
{
    "dept_no":19
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.jiandaoyun.com/api/v5/corp/guest/user/list' \
--header 'Content-Type: application/json' \
--data-raw '{
    "dept_no":19
}'

返回响应

🟢200成功
application/json
Body
member_list
array [object {6}] 
企业对接人内容数组
必需
name
string 
昵称
必需
username
string 
用户名
必需
departments
array[integer]
必需
type
integer 
必需
部门类型 0: 常规部 2: 企业互联外部部门
status
integer 
必需
部门状态: 1: 使用中的部门 -1: 集成模式下同步后删除的部门
integrate_id
string 
可选
集成模式同步部门关联 ID
示例
{
    "member_list": [
        {
            "name": "Purl",
            "username": "R-ww9a61c11fc226842f-#admin",
            "departments": [
                19
            ],
            "type": 2,
            "status": 1
        }
    ]
}
上一页
列出我连接的企业
下一页
获取我连接的企业对接人的详细信息
Built with