Dokumentacja API
Obsługa Błędów
Standardowe kody błędów, nagłówki limitów i rozwiązywanie problemów.
Ostatnia aktualizacja:
Obsługa błędów
Wszystkie odpowiedzi błędów mają spójny format z kodem błędu i komunikatem czytelnym dla człowieka:
{
"error": {
"code": "ERROR_CODE",
"message": "Description of what went wrong"
}
}Kody błędów
| HTTP Status | Code | Description |
|---|---|---|
| 400 | VALIDATION_ERROR | Nieprawidłowe lub brakujące parametry żądania |
| 401 | UNAUTHORIZED | Brakujący lub nieprawidłowy klucz API |
| 402 | PAYMENT_REQUIRED | Niewystarczająca liczba kredytów |
| 403 | FORBIDDEN | Dostęp do API wymaga planu Business lub działanie jest niedozwolone |
| 403 | LIMIT_EXCEEDED | Osiągnięto limity planu (projekty, buildy itp.) |
| 404 | NOT_FOUND | Zasób nie został znaleziony lub jest niedostępny |
| 409 | CONFLICT | Konflikt zasobu (wdrożenie w toku, zajęta domena itp.) |
| 429 | RATE_LIMITED | Zbyt wiele żądań — sprawdź nagłówki limitu szybkości |
| 500 | INTERNAL_ERROR | Błąd serwera — spróbuj ponownie lub skontaktuj się z pomocą techniczną |
Nagłówki limitu szybkości
Każda odpowiedź zawiera te nagłówki:
X-RateLimit-Remaining— Liczba pozostałych żądań w bieżącym oknieX-RateLimit-Reset— Sekundy do zresetowania okna limitu szybkości
Po otrzymaniu odpowiedzi 429 poczekaj liczbę sekund wskazaną przez X-RateLimit-Reset przed ponowieniem próby.
Koszty kredytów
Akcje API, które zużywają kredyty:
| Action | Credits |
|---|---|
| Tworzenie projektu (wstępny build) | 5 |
| Ulepszenie | 1 |
| Edycja kodu | 1 |
| Ponowne wdrożenie | 1 |
| Cofnięcie wdrożenia | 1 |
| Klonowanie | 2 |
| Reaktywacja | 1 |
| Pytanie do doradcy | 1 |
Administratorzy są zwolnieni z opłat w kredytach.
Rozwiązywanie problemów
- 401 Unauthorized — Sprawdź, czy klucz API zaczyna się od
flp_i jest przekazany jako token Bearer - 403 Forbidden — Upewnij się, że konto ma aktywną subskrypcję Business
- 409 Conflict przy wdrożeniu — Poczekaj na zakończenie bieżącego wdrożenia lub najpierw je anuluj
- Błędy subdomeny — Subdomeny muszą być pisane małymi literami, mieć 3–63 znaki i zawierać tylko litery, cyfry oraz myślniki