钉钉开发文档

1. 用用类型

应用类型	支持能力	是否支持上架到钉钉应用广场
企业内部应用	小程序（支持移动端） H5微应用（支持移动端和PC端） 机器人	否
第三方企业应用	小程序（支持移动端） H5微应用（支持移动端和PC端）	是
第三方个人应用	小程序（支持移动端）	否

2.  访问凭证

•  获取企业内部应用的access_token 
  GET https://oapi.dingtalk.com/gettoken?appkey=appkey&appsecret=appsecret
• 服务商获取第三方应用授权企业的access_token 
• 获取jsapi_ticket
• 获取微应用后台免登的access_token
  GET https://oapi.dingtalk.com/sso/gettoken?corpid=ding1234&corpsecret=12345

3. 获取用户个人身份凭证

• 获取登录用户的访问凭
  创建应用 -> 钉钉登录与分享 -> 添加回调URL -> OAuth登录授权 -> 构造登录授权页面
  
   https://login.dingtalk.com/oauth2/auth?
  redirect_uri=https%3A%2F%2Fwww.aaaaa.com%2Fa%2Fb  回调地址须做urlencode
  &response_type=code    固定值为code
  &client_id=dingbbbbbbb  AppKey
  &scope=openid               授权后可获得用户userid
  &state=dddd                    跟随authCode原样返回
  &prompt=consent            值为consent时，会进入授权确认页
• 获取用户token

  POST /v1.0/oauth2/userAccessToken HTTP/1.1
  Host:api.dingtalk.com
  Content-Type:application/json

  {
    "clientId" : "String",             AppKey
    "clientSecret" : "String",     AppSecret
    "code" : "String",                 临时授权码
    "grantType" : "String"          authorization_code
  }

4. 应用身份相关访问凭证

• 获取应用的API访问凭证
  GET https://oapi.dingtalk.com/gettoken?appkey=appkey&appsecret=appsecret
• 获取工作台API访问凭证
  开发者后台首页，生成TOKEN
• 获取企业内部应用的accessToken

  POST /v1.0/oauth2/accessToken HTTP/1.1
  Host:api.dingtalk.com
  Content-Type:application/json

  {
    "appKey" : "String",
    "appSecret" : "String"
  }

• 获取第三方应用授权企业的accessToken

• 创建jsapi ticket

• 获取微应用后台免登的access_token

  POST /v1.0/oauth2/ssoAccessToken HTTP/1.1
  Content-Type:application/json

  {
    "corpid" : "String",        企业的corpId
    "ssoSecret" : "String"   sso密钥
  }

5. 身份验证（免登）

身份验证支持的免登场景

• 企业内部应用免登
  获取免登授权码 -> 获取access_token（oapi.dingtalk.com/gettoken）-> 获取用户userid -> 获取用户详情

• 应用管理后台免登
  获取免登授权码 -> 调用sso/gettoken接口获取应用后台免登的access_token -> 调用接口获取应用管理员的身份信息

• 登录第三方网站
  创建并配置应用->添加接口调用权限->配置内网穿透​​​​​​​->设置第三方网站的回调域名​​​​​​​->搭建后端服务​​​​​​​->构造登录的第三方网站的访问地址->访问第三方网站地址

  • 浏览器内实现

    • 扫码登录

    • 使用钉钉账号密码方式登录

  • 钉钉客户端内免登第三方网站

6. 通讯录管理

• 用户管理

  • 创建用户

  • 更新用户信息

  • 删除用户

  • 查询用户详情 （userid）

  • 获取部门用户基础信息 （dept_id）

  • 获取部门用户userid列表

  • 获取部门用户详情

  • 获取员工人数

  • 获取未登录钉钉的员工列表

  • 根据手机号查询用户

  • 根据unionid获取用户userid

  • 获取管理员列表

  • 获取管理员通讯权限范围

  • 查询里只记录列表

  • 设置高管模式

  • 获取用户高管模式设置

  • 删除用户属性可见性设置

  • 获取用户属性可见性设置

  • 获取用户属性可见性设置

  • 设置用户属性可见性

• 专属账户
• 部门管理
• 角色管理
• 外部联系人
• 企业管理
• 通讯录可见性管理
• 行业通讯录
• 获取用户通讯录个人信息
• 通讯录事件