SuperAPI AI 工具集

persona-common-errors

编程与开发

查看项目

更新于 10-15 23:28

技能介绍

用途:当 Persona 集成出现认证、JSON:API、Inquiry、会话、Webhook 或限流失败时,按由外到内的顺序进行故障分诊,先冻结证据再逐层排查。

主要能力:记录 UTC 时间、方法、规范主机与路径、API 版本、状态码、请求 ID、幂等键哈希与响应体哈希;核对 api.withpersona.com、目标环境、密钥状态、权限与显式版本;校验 JSON:API 结构、模板选择器、内容头、账户自动创建元数据与重放参数;在重试创建、恢复或状态转换前先读取 Inquiry,区分 pending、终态、已脱敏与不可用资源;验证 Webhook 事件接收,使用原始字节、timestamp 加点加 body 的 HMAC、全部 v1 候选、常量时间比较、事件 ID 去重与创建时间排序;读取实时 RateLimit-* 与 Quota-* 头及 Dashboard 配额,遇 429 时降低相关通道并使用有界退避。

使用方式:REST 诊断使用正确环境的 bearer key,Webhook 诊断使用端点签名密钥,两者在创建工单或调试包前均需脱敏。用 Read 与 Grep 检查配置、文档、fixture、schema、测试与脱敏证据,仅在获批后使用 Write 或 Edit。未经操作者明确批准,不得创建、恢复、批准、拒绝、脱敏、轮换、撤销或部署生产 Persona 资源。

适用场景:集成失败排查、错误码分诊(401/403、400/422、404、429)、幂等重放核对、Webhook 验签与去重、限流应对。

限制:资料未提供具体安装命令、价格与平台支持信息;成功请求不等于身份决策成功,需对照第一方证据、固定 API 版本与回滚路径验证。