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자이며, 문자, 숫자, 하이픈만 포함해야 합니다