用途:该技能封装 Coda API,用于在代理或工具脚本中操作 Coda 文档、页面、表格与行,适合读取或写入 Coda 数据的场景。用户提到 Coda、coda.io、Coda 文档链接、Coda 表格或文档读写需求时可使用。
鉴权与基础:基址为 https://coda.io/apis/v1,所有请求使用请求头 Authorization: Bearer $CODA_TOKEN。可用 curl -s "https://coda.io/apis/v1/whoami" --header "Authorization: Bearer $CODA_TOKEN" | jq '{name, loginId, type, tokenName, scoped, workspace: .workspace.name}' 验证令牌。连接失败时可运行 zero doctor check-connector --env-name CODA_TOKEN,或 zero doctor check-connector --url https://coda.io/apis/v1/whoami --method GET 排查。
主要能力:列出文档(支持 isOwner、query、workspaceId、limit、pageToken 参数)、创建文档(可传 sourceDoc、folderId)、获取文档、列出与获取页面、导出页面内容(支持 html 或 markdown,为两步异步流程,先请求导出再轮询下载链接)、列出与获取表格、列出列、列出与获取行(支持 useColumnNames、valueFormat、query、sortBy、limit、pageToken)、插入或 upsert 行、更新行、删除行,以及查询 mutationStatus 确认写操作完成。另可调用 resolveBrowserLink 将浏览器链接解析为 API 资源 ID。
用法要点:文档 ID 为 URL 中 _d 后的 10 位代码;页面、表格、列、行 ID 可经列表接口获取或由 resolveBrowserLink 解析。读取行时 valueFormat 可选 simple、simpleWithArrays、rich。写入行使用 cells 数组,column 可填列 ID 或列名;省略 keyColumns 表示始终插入新行,提供 keyColumns 则按这些列匹配更新。写操作返回 202 与 requestId,需轮询 mutationStatus 直到 completed 为 true。列表接口通过 nextPageToken 分页。日期列接受 ISO-8601 字符串。
限制:令牌需具备相应文档权限;多数接口约每分钟 100 次请求,应合并批量写入,遇到 429 需退避重试。具体收费、配额及完整错误码资料未提供。