用途:通过 Quip Automation REST API 与 Quip(axon.quip.com)交互,支持读取、创建、编辑、搜索和整理文档与文件夹。适用于用户提供 axon.quip.com 链接并希望阅读、编辑或讨论文档,要求新建文档或文件夹、按关键词搜索、追加内容、查询文件夹结构或整理文档等场景。不适用于实时协作或对选中文本评论、上传大型二进制附件,以及需要 OAuth 流程的情况——此处仅支持 Bearer token 认证。
配置:需设置环境变量 QUIP_ACCESS_TOKEN,命令为 export QUIP_ACCESS_TOKEN="your-personal-access-token"。API 基础地址为 https://platform.quip.com/1/,人可访问的文档链接为 https://axon.quip.com/{thread_id},认证头为 Authorization: Bearer $QUIP_ACCESS_TOKEN。注意 API 基础是 platform.quip.com 而非 axon.quip.com,租户域名仅用于面向用户的链接;请求体编码必须为 application/x-www-form-urlencoded(不是 JSON);切勿在输出中回显或记录 token。
主要操作:从 URL 提取 thread ID:THREAD_ID=$(echo "https://axon.quip.com/XYZ123AbC" | sed 's|.*/||')。文档内容使用 HTML,创建或编辑时使用 format=html。GET threads/{thread_id} 读取文档;POST threads/new-document 创建文档,可传 title、content、format=html、type=document、member_ids;POST threads/edit-document 编辑文档,location 枚举 0=追加到末尾、1=前插到开头、2=指定区块之后、3=指定区块之前、4=替换指定区块、5=删除指定区块,2-5 需提供 section_id(来自 HTML 中的 data-section-id 属性);GET threads/search?query=...&count=... 搜索文档;GET users/current 获取 private_folder_id 与 shared_folder_ids;GET folders/{folder_id} 查看子项;POST folders/new 新建文件夹;POST folders/add-members 与 folders/remove-members 管理文件夹成员;POST messages/new 在文档或聊天线程中发布消息。
错误处理:400 检查参数名与编码,401 检查 token,403 无权限,404 检查 ID,429 等待并指数退避重试,500 重试一次,持续失败则上报。写操作后应校验 HTTP 200、响应含预期字段、文档 URL 可解析,编辑后重新获取文档确认变更,并确认 token 未被回显。