Skip to main content
首先,你需要从开发者控制台获取一个 API 密钥。你可以使用该 API 密钥向 Square Cloud API 进行身份验证。

API 使用

你可以使用 API 密钥向 Square Cloud API 进行身份验证。你可以将 API 密钥放在 Authorization 请求头中。 请记住,API 的使用受服务条款可接受使用政策的约束。

错误代码

错误响应遵循 { "status": "error", "code": "SOME_CODE" } 格式。2026 年 7 月,多个代码已重命名为一致的命名规范(INVALID_XX_NOT_FOUNDX_FAILEDX_LIMIT_REACHED):完整对照表见更新日志

OpenAPI 规范

Square Cloud API 发布了一份机器可读的 OpenAPI 规范,描述了每一个端点、参数、模式和身份验证方法。你可以用它来生成客户端、将 API 导入到 Postman 或 Insomnia 等工具中,或让你自己的集成与最新的更改保持同步。

限制与约束

了解 Square Cloud API 的限制与约束。