说在前面

虽然 ali-sdk 中有官方维护的 钉钉 SDK，但是很遗憾已经有一年未更新了。另外从 Issue 上看官方也没有计划来更新，所以才有了本库。

本库主要解决目前 node-dingtalk 两个问题：

• 很多接口已经不再适用；
• 调用方式也发生了改变（不推荐使用 corpId 及 corpSecret 参数）

使用

const DingTalk = require('node-dingtalk-latest');
const dingtalk = new DingTalk({
  appKey: '',
  appSecret: '',
  loginAppId: '',
  loginAppSecret: ''
});

await dingtalk.message.sendMessage({
  agent_id: '',
  userid_list: '',
  msg: {
    'msgtype': 'text',
    'text': {
      'content': `Ryoma 的 测试：${Date.now()}`,
    },
  },
});

Cache

引入 Cache 的理由与官方一样，在 cluster 下换成 Redis 等外部存储降低获取 AccessToken 频率。

API

目前支持的 API，主要以我目前使用的为主，欢迎大家提需求

Client

getAccessToken

GET /gettoken

获取 AccessToken, 并在有效期内自动缓存

Auth

getQRGotoUrl

获取内嵌二维码的 goto url

getUserInfoByCode

/sns/getuserinfo_bycode

通过 code 获取用户信息

Note：扫码获取 tmpAuthCode 后，需要手动构造一个链接，该链接会 302 到重定向地址，此时的 code 才可使用

Message

sendMessage

POST /topapi/message/corpconversation/asyncsend_v2

发送工作通知消息

getSendProgress

POST /topapi/message/corpconversation/getsendprogress

查询工作通知消息的发送进度

getSendResult

POST /topapi/message/corpconversation/getsendresult

查询工作通知消息的发送结果

recallMessage

POST /topapi/message/corpconversation/recall

工作通知消息撤回

User

getDeptUserIds

GET /user/getDeptMember

获取部门用户 userid 列表

getDeptUserSimples

/user/simplelist

获取部门部分用户基本信息

getDeptAllUserSimples

/user/simplelist

获取部门所有用户基本信息，基于 /user/simplelist 接口封装

getDeptUsers

/user/listbypage

获取部门部分用户详情

getDeptAllUsers

/user/listbypage

获取部门所有用户信息，基于 /user/listbypage 接口封装

getUser

/user/get

获取用户详情

getUserIdByUnionId

/user/getUseridByUnionid

根据 unionid 获取 userid

getOrgUserCount

/user/get_org_user_count

获取企业员工数

Department

getSubDepts

/department/list

获取子部门列表——支持迭代获取子部门

getSubDeptIds

/department/list_ids

获取子部门 ID 列表——不支持迭代获取子部门 ID 列表

getDepartment

/department/get

获取部门详情

注意

• 测试时，请在 test/test.config.js 填上自己的配置