API 参考
错误处理
标准错误代码、速率限制标头和故障排除。
最后更新：
错误处理
所有错误响应遵循统一格式，包含错误代码和可读的错误消息：
{
"error": {
"code": "ERROR_CODE",
"message": "Description of what went wrong"
}
}错误代码
| HTTP Status | Code | Description |
|---|---|---|
| 400 | VALIDATION_ERROR | 请求参数无效或缺失 |
| 401 | UNAUTHORIZED | API 密钥缺失或无效 |
| 402 | PAYMENT_REQUIRED | 积分不足 |
| 403 | FORBIDDEN | API 访问需要 Business 计划，或操作不被允许 |
| 403 | LIMIT_EXCEEDED | 已达到计划限额（项目数、构建次数等） |
| 404 | NOT_FOUND | 资源不存在或无法访问 |
| 409 | CONFLICT | 资源冲突（部署进行中、域名已被占用等） |
| 429 | RATE_LIMITED | 请求过于频繁 — 请检查速率限制响应头 |
| 500 | INTERNAL_ERROR | 服务器错误 — 请重试或联系支持 |
速率限制响应头
每个响应均包含以下响应头：
X-RateLimit-Remaining— 当前窗口内剩余的请求次数X-RateLimit-Reset— 距速率限制窗口重置的秒数
收到 429 响应时，请等待 X-RateLimit-Reset所指示的秒数后再重试。
积分消耗
消耗积分的 API 操作：
| Action | Credits |
|---|---|
| 创建项目（初始构建） | 5 |
| 优化 | 1 |
| 代码编辑 | 1 |
| 重新部署 | 1 |
| 回滚 | 1 |
| 克隆 | 2 |
| 重新激活 | 1 |
| 顾问提问 | 1 |
管理员免除积分扣除。
故障排查
- 401 Unauthorized — 确认您的 API 密钥以
flp_开头，并作为 Bearer 令牌包含在请求中 - 403 Forbidden — 确认您的账户拥有有效的 Business 订阅
- 409 Conflict on deploy — 请等待当前部署完成，或先取消它
- 子域名错误 — 子域名必须为小写字母，长度 3-63 个字符，且只能包含字母、数字和连字符