常用 API 文档与示例
1. 获取 access_token
所有服务端 API 的第一步。需使用 AppKey 和 AppSecret。
请求地址：https://oapi.dingtalk.com/gettoken?appkey=xxx&appsecret=yyy
注意：access_token 有效期 7200 秒，建议缓存并定时刷新。
2. 通过临时授权码获取用户信息
适用于扫码登录或免登场景。
接口：/sns/getuserinfo_bycode
关键参数：tmp_auth_code（前端 JSAPI 获取）
常见问题：tmp_auth_code 5 分钟失效，且只能使用一次。
3. 发送工作通知（异步）
向企业员工发送消息，支持文本、链接、OA 等类型。
接口：/topapi/message/corpconversation/asyncsend_v2
权限要求：应用需开通“工作通知”权限，并配置接收人范围。
4. 获取部门与用户列表
用于同步组织架构。
接口：/department/list + /user/list
建议：分页拉取，避免超时；注意子部门嵌套结构。