Square

Square API 集成,安全托管 OAuth 管理

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Square。
它的用途是:Square API 集成,安全托管 OAuth 管理
完整的 Skill 内容见:https://321skill.com/skills/square-x-2/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'帮我连接 Square 账户,使用最小权限 OAuth 范围,只允许读取交易数据',它会自动触发 Square 的 OAuth 授权流程,生成一个安全连接并返回连接 ID。之后你可以继续请求:'查询最近30天的交易记录',技能会使用该连接 ID 调用 Square API 并返回结果。

介绍

Square 是一款强大的支付与业务管理平台,但直接集成其 API 需要处理复杂的 OAuth 流程和权限管理。本技能通过托管 OAuth 机制,让你无需手动管理令牌刷新和权限范围,即可安全调用 Square 的各类 API,包括支付、订单、商品、客户等核心功能。

使用本技能时,只需提供你的 Square 应用凭证,系统会自动完成 OAuth 授权流程,并为你维护一个最小权限的连接。每次请求前,技能会验证连接 ID 是否与预期一致,确保请求不会误操作到其他账户。闲置连接会被自动撤销,进一步降低安全风险。

适合需要管理 Square 后台的开发者、运维人员或电商运营者。无论你是要批量处理订单、同步商品信息,还是分析交易数据,只要你的场景需要通过编程方式操作 Square 账户,本技能都能提供安全可靠的接入层。

建议在安装前确认你确实需要 Square 管理功能。连接时请使用专用于此技能的 Square 账户,并只授予必要的 OAuth 范围(如仅读取交易数据,不授予写入权限)。定期检查连接状态,及时撤销不再使用的连接。

核心特点

与其它 Square API 集成方案相比,本技能内置了完整的托管 OAuth 生命周期管理,自动采用最小权限范围,并在每次请求前强制验证连接 ID,避免因连接误用导致的数据泄露或误操作。

注意事项

不适合没有 Square 账户或仅需公开 API 查询(如无需 OAuth 的公共数据)的场景。

常见问题

如何获取 Square 应用的 OAuth 凭证?

登录 Square Developer Dashboard,创建应用后获取 Application ID 和 Secret,并正确配置 Redirect URL。

连接被撤销后如何重新授权?

重新执行安装流程,系统会引导你重新完成 OAuth 授权步骤,生成新的连接。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/square-x-2/raw/index.md 读取 Square 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。