Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
服务端API
  • 历史文档(不推荐)
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API(DingTalk OpenAPI)
  • 生态伙伴API
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
  1. 合作空间
  • 合作空间
    • 获取加入或申请加入合作空间的组织和个人信息
      POST
    • 获取企业已经加入或申请加入的合作空间的信息
      POST
    • 创建合作空间
      POST
    • 获取合作空间的邀请信息
      GET
  • 关联组织
    • 获取主干组织列表
      POST
    • 获取分支组织列表
      POST
    • 获取关联组织分支授权的数据
      POST
  • 服务窗
    • 批量发送服务窗消息
      POST
    • 发送服务窗单人消息
      POST
  1. 合作空间

获取加入或申请加入合作空间的组织和个人信息

POST
http://127.0.0.1/topapi/union/cooperate/info/list
服务端API/互联平台/合作空间
最后修改时间:2022-08-30 09:19:22
责任人:未设置

说明#

调用本接口通过合作空间组织ID获取加入或申请加入合作空间的组织和个人信息。
服务地址:https://oapi.dingtalk.com

权限#

服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。
应用类型是否支持调用权限申请方式API Explorer调试
企业内部应用是开发者后台申请调试
第三方企业应用是开发者后台申请调试
第三方个人应用否——

请求参数

Query 参数
access_token
string 
必需
调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。
示例值:
Be31xxxx
Body 参数application/json
status
number 
必需
加入空间的状态:0:申请中的1:已成功加入
示例
{
  "status": "0"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1/topapi/union/cooperate/info/list?access_token=Be31xxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "status": "0"
}'

返回响应

🟢200成功
application/json
Body
result
array [object {8}] 
可选
加入或申请加入的空间信息。
auth_level
number 
可选
加入企业认证等级:0:未认证 1:高级认证 2:中级认证 3:初级认证
userids
array[string]
可选
单独加入的员工。所在部门不需要加入的情况,直接选择的几个员工。
dept_ids
array[number]
可选
加入的部门列表。部门下的员工会全部加入。
union_type
number 
可选
加入的方式:1:全部加入(不需要选择部门和员工) 2:部分加入
dept_name
string 
可选
挂载部门名称(在合作空间中的架构属性),不设置默认是加入企业的名称。
dept_id
number 
可选
挂载部门ID(在合作空间中的架构属性)。
union_org_name
string 
可选
加入企业的企业名称。
union_corp_id
string 
可选
加入企业的企业corpId。
success
boolean 
调用是否成功。
可选
errcode
number 
返回码。
可选
errmsg
string 
返回码描述。
可选
示例
{
  "result": [
    {
      "auth_level": 0,
      "userids": [
        "string"
      ],
      "dept_ids": [
        0
      ],
      "union_type": 0,
      "dept_name": "string",
      "dept_id": 0,
      "union_org_name": "string",
      "union_corp_id": "string"
    }
  ],
  "success": true,
  "errcode": 0,
  "errmsg": "string"
}
下一页
获取企业已经加入或申请加入的合作空间的信息
Built with