用途:通过从浏览器手动提取的 Cookie 会话访问钉钉文档(alidocs.dingtalk.com),无需创建企业应用或获得管理员审批,也不受定制部署(如 AliDing、AntDing)不支持文档读取的限制。
主要能力:列出目录子节点、获取节点信息、读取原生 adoc 文档内容、将 adoc 导出为 PDF、下载支持下述扩展名的附件:pdf、doc、docx、xlsx、pptx、txt、md、png、jpg、jpeg。dlink/hlink 外链节点会先解析到目标节点再处理。
使用方式:每个请求需携带完整 Cookie 字符串和从 Cookie 中提取的 X-XSRF-TOKEN 请求头。认证失败会返回 301/302 重定向而非 401,解析响应前应先检查重定向。使用前需将 scripts/ 目录加入 sys.path,再异步调用 DingTalkClient,例如 async with DingTalkClient(cookie) as client。可调用 extract_space_id_from_url、extract_node_id_from_url 解析 URL,adoc 文档用 get_document_data() 配合 extract_text_from_alidocs() 提取文本,或 export_to_pdf() 导出 PDF。
限制:不支持表格文档;adoc 文档不能用 download_file() 下载;dlink/hlink 节点必须先解析;createExportJob 请求体不可传 dentryUuid 或 workspaceId;内置重试仅覆盖 429 与瞬时网络错误,更高层重试需调用方自行实现。资料中未提供安装命令、定价与平台支持信息。