SuperAPI AI 工具集

webflow-common-errors

编程与开发

查看项目

更新于 10-15 23:30

技能介绍

用途:该技能针对 Webflow Data API 调用失败,结合 HTTP 状态码与返回的结构化错误体进行诊断,适用于出现 4xx、429、5xx 响应时的排查场景。它以当前官方文档与目标项目实际安装版本为准,发现阶段保持只读,并把准备与实时变更分离。

主要能力:错误体包含 code、message、externalReference、details,可在脱敏后保留这些字段。可区分 400 输入格式错误、401 认证无效、403 权限不足、404 资源缺失、409 与当前状态冲突;429 应遵守 Retry-After,官方 SDK 含指数退避;5xx 可能为暂时性问题,但重试须有界且幂等,不确定的写操作不得盲目重放。认证方面,Data API 调用使用 bearer token:站点 token 用于受控单站点,workspace token 仅用于其支持的 workspace/读取用途,OAuth 用于用户授权应用;作用域需依据确切端点推导,绝不读取、回显、持久化令牌值或将其放入命令、补丁、示例、日志与报告中。

使用方式:先捕获操作、端点族、HTTP 状态、Webflow 错误码、请求 ID 或头部以及脱敏错误体;用相同客户端配置以最小的只读请求复现;在改动认证前先检查站点/资源 ID 与 staged/live 或 locale 选择;对 401/403 比较 token 类型与确切端点作用域,仅在确认吊销或泄露时轮换;对 429/5xx 区分读与写,遵守重试指引并加入抖动,达到有界次数后停止;最后返回含证据的诊断、最小修正以及先前写操作是否可能已成功的明确说明。默认仅只读检查,任何创建、更新、删除、发布、取消发布、归档、部署、吊销 token 或注册 webhook 前,需展示确切环境与资源 ID、拟议变更、验证方法和回滚或补偿动作,且生产发布或破坏性操作需新的明确批准。输出应包含项目与版本、已验证的 Webflow 身份、相关端点与作用域契约、拟议或已做变更、验证证据、实时变更状态、回滚准备与剩余风险,并区分文档事实、仓库证据与推断。

限制:资料未提供具体安装命令、收费信息或完整代码示例;实际令牌与端点细节需以用户自身配置和官方文档为准。