# Błędy i kody statusu

Znajdź przyczynę nieudanego żądania i zdecyduj, czy go naprawić, poczekać lub spróbować ponownie.

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/errors
Przegląd: 2026-11-04 przez FlashData

<a id="status-codes"></a>

## Kod statusu HTTP

Zacznij od statusu HTTP, a następnie przeczytaj kod błędu i wiadomość dla konkretnej przyczyny.

| Stan | Znaczenie | Co zrobić |
| --- | --- | --- |
| 400 | Nieprawidłowy wniosek | Przed ponownym uruchomieniem poprawiaj źródło, wymagane pola, typy parametrów lub nagłówki odpowiedzi. |
| 401 | Uwierzytelnianie nie powiodło się | Sprawdź X-API-Key. Zastąp utracony lub cofnięty klucz; ponowne użycie tego samego klucza nie pomoże. |
| 402 | Niewystarczające kredyty | Sprawdź stan konta. Dodaj kredyty lub pozwól właścicielowi konta rozwiązać dostęp przed przedłożeniem ponownie. |
| 403 | Odmowa dostępu | Sprawdź prawa źródłowe klucza oraz status konta lub subskrypcji. |
| 404 | Nie znaleziono | Sprawdź URL, zadanie ID i konto. Praca poza dozwolonym kontem lub źródłami może również zwrócić 404. |
| 406 | Typ odpowiedzi nie do przyjęcia | Użyj Accept: application/json lub text/plain. Wybierz Markdown z X-Respond-With: markdown. |
| 409 | Wynik niegotowy / konflikt | Na wynik przeczytaj, przeprowadź badanie istniejącej pracy aż do zakończenia. Dla innych punktów końcowych, rozwiązać konflikt opisany w organizmie. |
| 410 | Wynik wygasł | Użyj zapisanej kopii. Pobieranie wyniku URL nie może przywrócić przeterminowanego wyniku. |
| 422 | Nieprawidłowe zadanie wejścia / nieudanego zadania | Napraw zgłoszone pola. Na wynik przeczytany, Inspect job.error: nieudany zadanie nie ma udanego wyniku do pobrania. |
| 429 | Osiągnięty limit | Poczekać na Retry-After lub retry_after. Zredukuj stawkę żądania; dla pełnej oczekujących kolejki, czekać na istniejące zadania do finish. |
| 500 / 502 / 503 / 504 | Usterka serwisowa lub awaryjna | Retry czyta z ograniczonym zapleczem. Dla POST lub timeout składania, sprawdzić, czy praca została zaakceptowana przed wysłaniem go ponownie. |

- [Zaznacz klawisze API](https://flashdata.dev/app/api-keys)
- [Kredyty i ceny](https://flashdata.dev/pl/docs/guides/credits-and-billing/reference.md)
- [Limity stóp procentowych](https://flashdata.dev/pl/docs/guides/usage-and-limits/reference.md)

<a id="response"></a>

## Odczytaj odpowiedź błędu

Błędy API używają JSON, w tym również w przypadku żądania zwykłego tekstu. Ciało różni się w zależności od punktu końcowego. Oddział na statusie i kodzie HTTP, gdy jest obecny; użyj wiadomości lub szczegółów, aby wyjaśnić problem.

### Query API

Błędy w zapytaniu często zawierają błąd i wiadomość; kod jest opcjonalny. Błędy uwierzytelniania mogą stosować success: false zamiast error: true.

#### 400 · application/json

```json
{
  "error": true,
  "code": "unsupported_representation",
  "message": "X-Respond-With supports markdown. Omit the header for the original result fields."
}
```


### API zarządzania

V2 odpowiedzi problem używać application/problem+json. Dla wsparcia należy przechowywać requestId. Błędy walidacji mogą również obejmować fieldErrors z polem, kodem i wiadomością.

#### 401 · application/problem+json

```json
{
  "type": "https://api.flashdata.dev/problems/invalid_api_key",
  "title": "Invalid API Key",
  "status": 401,
  "code": "invalid_api_key",
  "requestId": "example-request-id",
  "detail": "The API Key is invalid or unavailable."
}
```



<a id="diagnostics"></a>

## Stan kontroli, nagłówki i ciało

Używać curl --include, aby zobaczyć wszystkie trzy. Ten przykład sprawdza Twój klucz za pomocą darmowego odczytu konta; nie wysyła zapytania. Najpierw ustaw FLASHDATA_API_KEY w swoim środowisku.

### Sprawdzić odpowiedź · cURL / Bash

```bash
curl --include --silent --show-error --max-time 20 \
  'https://api.flashdata.dev/v2/api-access/identity' \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Accept: application/json'
```

- [Konfiguracja uwierzytelniania](https://flashdata.dev/pl/docs/guides/headers-and-authentication/reference.md)
- [Rozwiązywanie problemów przez objaw](https://flashdata.dev/pl/docs/guides/troubleshooting/reference.md)

<a id="retries"></a>

## Kiedy spróbować ponownie

Powtórzone POST może utworzyć kolejne billable query. Czas trwania sieci nie dowodzi, że pierwszy wniosek został odrzucony. Zapisz pracę ID jak tylko ją otrzymasz.

| Sytuacja | Następna akcja |
| --- | --- |
| Nieprawidłowe wejście, klucz, pozwolenie lub równowaga | Przestań. Przed ponownym uruchomieniem należy naprawić żądanie lub stan konta; nie pętli tych błędów. |
| 429 z podpowiedź oczekiwania | Honor Retry-After (sekundy lub data HTTP) lub wartość JSON retry_after w sekundach. Jeśli obie są obecne, należy użyć dłuższego opóźnienia. |
| Read request: 429 / internal 5xx / network error | Zmień GET. Bez podpowiedzi, użyj zwiększających się opóźnień z jitter, maksymalnej liczby prób i limitu czasu. |
| POST timeout lub digital 5xx | Zachowaj dotychczasową pracę ID i sprawdź jej status. Jeśli nie otrzymano ID, przed podjęciem decyzji o ponownym złożeniu sprawdź historię pracy. |

- [Historia pracy](https://flashdata.dev/app/jobs)
- [Odzyskanie zadania agenta](https://flashdata.dev/pl/docs/guides/agent-recovery/reference.md)

<a id="job-status"></a>

## Sprawdź pracę w tle

HTTP 200 od punktu końcowego stanu oznacza, że odczyt się powiódł. Sprawdź job.status, aby wiedzieć, czy zadanie się powiodło. Ustaw JOB_ID do istniejącego zadania; to polecenie nie wysyła zastępstwa.

| job.status | Co zrobić |
| --- | --- |
| pending / processing | Czekaj, przeprowadź sondaż tej samej pracy. Wynik odczytu zwraca 409 do zakończenia. |
| completed | Odzyskać i zapisać wynik. Oryginalne wyniki JSON zwracają 302 przekierowanie pamięci; sformatowane wyniki zwracają ciało bezpośrednio. |
| failed | Zatrzymaj sondaże i sprawdź job.error. Wynik końcowy zwraca 422 kodem result_not_ready dla nieudanego zadania. |

### Odczytuj status zadania · cURL / Bash

```bash
curl --fail-with-body --silent --show-error --max-time 30 \
  "https://api.flashdata.dev/v2/jobs/${JOB_ID:?Set JOB_ID}" \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Accept: application/json'
```

- [Sprawdź status · Python i cURL](https://flashdata.dev/pl/docs/reference/realtime-and-async/reference.md#status)
- [Pobieranie zakończonych wyników](https://flashdata.dev/pl/docs/reference/realtime-and-async/reference.md#results)
- [Postęp w pracach Bulk](https://flashdata.dev/pl/docs/reference/bulk-processing/reference.md#getBulkJob)

<a id="response-formats"></a>

## Błędy w formacie odpowiedzi

| Stan / kod | Napraw |
| --- | --- |
| 400 · unsupported_representation | Ustaw X-Respond-With na markdown lub usuń nagłówek. |
| 406 · not_acceptable | Ustaw Accept na application/json lub text/plain; użyj UTF-8, jeśli zostanie określony zestaw znaków. |

- [Przykłady formularzy zapytań i odpowiedzi](https://flashdata.dev/pl/docs/guides/response-formats/reference.md)

<a id="support"></a>

## Skontaktuj się z pomocą z prośbą

Wyślij punkt końcowy, znacznik czasu UTC, status HTTP, kod błędu i żądanie lub zadanie ID. Usuń z raportu klucze API, żetony i podpisane URLs.

- [Kontakt z pomocą techniczną](https://flashdata.dev/pl/contact)
