SuperAPI AI 工具集

canva-sdk-patterns

编程与开发

查看项目

更新于 10-15 22:42

技能介绍

用途:把 Canva Connect REST 适配器当作传输边界来实现,而非授权判定器或官方 SDK。适用于按固定 OpenAPI 契约生成或手写请求类型、响应校验、错误归一化与受限重试。

主要能力:先只列出必需的操作、scope、请求/响应结构、异步任务状态与预览标志;对 OpenAPI 契约与生成器版本做固定或校验和;定义显式操作方法、归一化错误、响应校验、超时上下文与不透明的请求/任务元数据;校验必需字段,在契约允许时接受新增未知字段,拒绝不安全的类型或状态漂移;对进行中/成功/失败建模;仅对分类为安全的读操作或已对账操作做有界重试。

使用方式:认证上,Canva Connect 调用使用后端通过 OAuth 2.0 Authorization Code 加 SHA-256 PKCE 获取的 Bearer 访问令牌;请求最小权限 scope,客户端密钥与令牌不得进入浏览器可见状态,刷新需串行化并原子存储一次性替换刷新令牌。策略与令牌轮换须留在通用请求方法之外,通用客户端不得选择角色、扩大 scope、并发刷新或记录请求体。发现用 Read 与 Grep,仅对已批准的产物、代码、配置、测试或回执使用 Write 或 Edit。

适用场景:生成 TypeScript 传输层覆盖用户、设计与导出等操作,而租户授权、刷新串行化、操作标识与结果留存仍由应用服务负责。

限制:资料未提供具体语言运行时、包策略、必需操作清单、OpenAPI 校验和与生成配置、授权与数据边界细节,也未提供收费、价格或平台信息;生成差异若改变 scope 需授权与同意审查,客户端自动重试写操作须禁用并补充对账,未知响应字段导致解析失败时按允许范围采用增量安全校验,适配器记录请求体或令牌须阻止发布并整改。