dingtalk-sdk 是一个钉钉开放平台的第三方 Python SDK, 实现了 企业内部开发 和 应用服务商(ISV)的 API。
企业内部开发
建议在使用前先阅读 钉钉开放平台文档
消息实体
表单组件
钉钉企业内部开发接口
考勤接口
公告接口
审批流接口
日程接口
回调接口
会话接口
签到接口
钉盘接口
部门接口
智能人事
外部联系人接口(废弃)
外部联系人接口
健康接口
消息接口
微应用接口
日志接口
角色接口
淘宝接口
用户接口
待办接口
应用服务商(ISV)
钉钉应用服务商(ISV)接口
钉钉企业内部开发接口
未实现接口
由于钉钉接口过多,文档较分散,有未实现的接口可以提交 Issues, sdk未更新时候可根据下面代码临时使用 post/get接口中的access_token,top接口中的session会在请求时自动设置,无需手动添加
安装与升级
目前 dingtalk-sdk 支持的 Python 环境有 2.7, 3.4, 3.5, 3.6 和 pypy。
dingtalk-sdk 消息加解密同时兼容 cryptography 和 PyCrypto, 优先使用 cryptography 库。 可先自行安装 cryptography 或者 PyCrypto 库:
#安装 cryptographypip install cryptography>=0.8.2# 或者安装 PyCryptopip install pycrypto>=2.6.1
为了简化安装过程,推荐使用 pip 进行安装
pip install dingtalk-sdk# with cryptographypip install dingtalk-sdk[cryptography]# with pycryptopip install dingtalk-sdk[pycrypto]
升级 dingtalk-sdk 到新版本:
pip install -U dingtalk-sdk
如果需要安装 GitHub 上的最新代码:
pip install https://github.com/007gzs/dingtalk-sdk/archive/master.zip