什么是企业账号
企业账号是组织/企业可管理的账号,包括创建、修改、停用、启用等对账号整个生命周期的操作都可由组织进行管理。更多企业账号详情可参考钉钉使用手册-企业账号介绍。 目前有以下两种类型:- SSO账号:使用组织内部已有的账号体系登录钉钉,账号管理在钉钉外。
- 钉钉企业账号:在钉钉创建并进行管理的企业账号。
如何开通企业账号
该功能目前仍在灰度测试中,如果您所在组织尚未开通,请先填写试用申请。企业账号开放的接口能力
企业账号提供了丰富的接口开放能力,开发者通过API接口可以实现企业账号和企业业务系统打通。| API | 说明 | 新版规范(新版服务端API) | 旧版规范(服务端API) |
|---|---|---|---|
| 创建企业账号用户 | 创建企业账号新用户。 | - | 创建企业账号用户 说明 文档已迁移至历史文档目录下。 - 如果未使用本接口,推荐根据账号类型选择使用创建SSO企业账号或者创建钉钉自建企业账号或者邀请其他组织企业账号加入接口。 - 如果已使用本接口,建议您根据自身实际情况评估是否切换至推荐接口。 |
| 创建SSO企业账号 | 创建SSO企业账号新用户。 | - | 创建SSO企业账号 |
| 创建钉钉自建企业账号 | 创建钉钉自建企业账号新用户。 | - | 创建钉钉自建企业账号 |
| 邀请其他组织企业账号加入 | 邀请其他组织企业账号加入。 | - | 邀请其他组织企业账号加入 |
| 更新企业账号用户信息 | 更新指定的企业账号用户信息。 | - | 更新企业账号用户信息 |
| 查询企业账号用户详情 | 获取指定企业账号用户的详细信息。 | - | 查询企业账号用户详情 |
| 获取部门企业账号用户详情 | 获取指定部门中的用户详细信息。 | - | 获取部门企业账号用户详情 |
| 根据手机号查询企业账号用户 | 根据手机号获取企业账号用户的userId。 | - | 根据手机号查询企业账号用户 |
| 启用企业账号 | 启用指定企业账号。 | 启用企业这账号 | - |
| 停用企业账号 | 停用指定的企业账号。 | 停用企业账号 | - |
| 强制登出企业账号 | 强制登出指定的企业账号。 | 强制登出企业账号 | - |
| 查询企业账号状态 | 查询某企业账号的启用状态。 | 查询企业账号状态 | - |
| 授权企业账号可加入多组织 | 授权企业账号可以加入多个组织。 | 授权企业账号可加入多组织 | - |
| 查询企业账号拥有的组织 | 查询企业账号在哪些企业下拥有创建者身份,并获取这些企业信息。 | 查询企业账号拥有的组织 | - |
| 企业账号转交主管理员(创建者) | 将本组织内某企业账号有所有权的组织,转交给另一企业账号,如果接收的账号不在该组织内则自动加入。 | 企业账号转交主管理员(创建者) | - |
| 根据迁移后的dingId查询原dingId | 根据迁移后的dingId查询原dingId。 | 根据迁移后的dingId查询原dingId | - |
| 根据迁移后的unionId查询原unionId | 根据迁移后的unionId查询原unionId。 | 根据迁移后的unionId查询原unionId根据迁移后的unionId查询原unionId | - |
| 根据原dingId查询迁移后的dingId | 根据原dingId查询迁移后的dingId。 | 根据原dingId查询迁移后的dingId | - |
| 根据原unionId查询迁移后的unionId | 根据原unionId查询迁移后的unionId。 | 根据原unionId查询迁移后的unionId | - |
名词解释
组织代码
由于企业账号归属于组织,在登录时需要通过输入组织代码告诉钉钉希望前往登录的组织。组织代码是使用企业账号组织的唯一标识。 当组织开通企业账号功能后,钉钉会默认分配一个8位随机的组织代码,您可以联系账号管理员在钉钉管理后台 > 设置 > 组织代码查看。同时组织管理员也可以申请更加个性化的代码,方便组织成员记忆和使用。