SuperAPI AI 工具集

persona-sdk-patterns

编程与开发

查看项目

更新于 10-16 06:20

技能介绍

用途:设计一个类型化的 Persona REST 适配器,在保留 JSON:API 信封、请求证据的同时,兼容后续新增字段与资源类型,适用于构建可复用客户端。

主要能力:将传输层、Persona 资源信封与领域决策分离;保留原始标识符和元数据;容忍新资源与字段;显式暴露变更证据,而不是把每个响应压平成脆弱的模型。

使用方式:先定义传输核心,集中管理 API 基址、Bearer 头、日期化版本、超时、请求 ID 和安全遥测,不要盲目重试变更操作;再通用化建模 JSON:API,处理 data、type、id、attributes、relationships、included、meta、links 及结构化错误,之后再加端点专用视图;把未知字段、资源类型、事件类型和数组顺序变化视为可安全保留或忽略的数据,而非解析失败;区分命令与查询,POST 命令需操作 ID 和 Idempotency-Key,查询可有界重试,命令在结果不明后核对已观察状态;只规范化证据而非身份,返回状态、请求 ID、速率与配额头、资源 ID 和脱敏信封哈希,客户属性保留在领域隐私边界内;用契约夹具测试错误、分页、未知字段、多种验证类型、会话元数据、限流和含糊的 POST 结果。

限制:认证需在传输边界注入环境作用域密钥并按请求固定 Persona-Version,调用方不得传递原始凭据或自选主机;未经操作员明确批准,不得创建、恢复、批准、拒绝、编辑、轮换、撤销、部署或以其他方式变更生产 Persona 资源;输出不得暴露 Bearer 密钥、Webhook 密钥、查询会话令牌、原始身份文档或不必要的 PII。变更后超时须先读取资源或操作证据再考虑重放。成功请求不证明身份决策成功。资料未提供具体安装命令、价格与平台信息。