钉钉企业内部开发接口

class dingtalk.client.DingTalkClient(corp_id, prefix='client', storage=None, timeout=None, auto_retry=True)[源代码]
get(uri, params=None, **kwargs)

get 接口请求

参数:
  • uri – 请求url
  • params – get 参数（dict 格式）
post(uri, data=None, params=None, **kwargs)

post 接口请求

参数:
  • uri – 请求url
  • data – post 数据（dict 格式会自动转换为json）
  • params – post接口中url问号后参数（dict 格式）
top_request(method, params=None, format_='json', v='2.0', simplify='false', partner_id=None, url=None, **kwargs)

top 接口请求

参数:
  • method – API接口名称。
  • params – 请求参数 （dict 格式）
  • format – 响应格式（默认json，如果使用xml，需要自己对返回结果解析）
  • v – API协议版本，可选值：2.0。
  • simplify – 是否采用精简JSON返回格式
  • partner_id – 合作伙伴身份标识。
  • url – 请求url，默认为 https://eco.taobao.com/router/rest

DingTalkClient 基本使用方法:

from dingtalk import SecretClient, AppKeyClient

client = SecretClient('corp_id', 'secret')  # 旧 access_token 获取方式
client = AppKeyClient('corp_id', 'app_key', 'app_secret')  # 新 access_token 获取方式

user = client.user.get('userid')
departments = client.department.list()
# 以此类推，参见下面的 API 说明
# client.chat.xxx()
# client.role.xxx()

如果不提供 storage 参数，默认使用 dingtalk.storage.memorystorage.MemoryStorage 类型， 注意该类型不是线程安全的，而且非持久化保存，不推荐生产环境使用。