# Ralat dan kod status

Dia mencari penyebab dari permintaan yang gagal dan memutuskan apakah akan memperbaikinya, menunggu atau mencoba lagi.

Referensi boonical: https://flashdata.dev/ms/docs/errors
Diulas: 2026-11-04 oleh FlashData

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

## Kode status HTTP

Mulai dengan status HTTP, kemudian baca kode kesalahan dan pesan untuk penyebab tertentu.

| Status | Arti | Tindakan |
| --- | --- | --- |
| 400 | Permintaan tidak sah | Baiki sumber, bidang yang diperlukan, parameter jenis atau header respon sebelum dicoba lagi. |
| 401 | Otentikasi Autentikasi gagal | Periksa X-API-Key. Megantikan sebuah kunci yang sudah kadaluarsa atau dicabut; mencoba lagi kunci yang sama tidak akan membantu. |
| 402 | Kredit tidak mencukupi | Periksa saldo rekening. Tambahkan kredit atau biarkan pemilik akun menyelesaikan akses sebelum mengajukan lagi. |
| 403 | Akses ditolak | Periksa hak dan akun sumber kunci atau status langganan. |
| 404 | Tidak ditemukan | Periksa URL, pekerjaan ID dan akun. Pekerjaan di luar akun atau sumber yang Anda ijinkan juga dapat mengembalikan 404. |
| 406 | Tipe respon tidak dapat diterima | Guna Accept: application/json OR atau ORANG text/plain. Pilih Markdown dengan X-Respond-With: markdown. |
| 409 | Hasil tidak siap / konflik | Pada hasil yang dibaca, jajak pendapat pekerjaan yang ada sampai selesai. Untuk titik akhir lainnya, selesaikan konflik yang dijelaskan dalam tubuh. |
| 410 | Hasil Hasil panen tamat tempoh | Guna salinan yang disimpan. Cabut kembali hasil URL tidak dapat memulihkan hasil yang sudah habis. |
| 422 | Input tidak sah / pekerjaan gagal | \"Fix: Fix the reported fields\". Pada pembacaan hasil, inspeksi job.error: pekerjaan yang gagal tidak memiliki hasil yang sukses untuk mengambil. |
| 429 | Batas tercapai | Tunggu Retry-After atau retry_after. Kurangi tingkat permintaan; untuk antrian tertunda penuh, tunggu untuk pekerjaan yang ada ke finish. |
| 500 / 502 / 503 / 504 | Layanan dan kegagalan hulu | Kau mencoba membaca dengan backoff terikat. Untuk POST atau submission timeout, periksa apakah pekerjaan diterima sebelum mengirimkannya lagi. |

- [Periksa kunci API](https://flashdata.dev/app/api-keys)
- [Kredit dan harga diri](https://flashdata.dev/ms/docs/guides/credits-and-billing/reference.md)
- [Batasan kadar laklak](https://flashdata.dev/ms/docs/guides/usage-and-limits/reference.md)

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

## Baca sebuah tanggapan kesalahan

Galat API menggunakan JSON, termasuk ketika anda meminta teks biasa. Tubuh berbeda dengan titik akhir. Branch pada status dan kode HTTP ketika ada; gunakan pesan atau detail untuk menjelaskan masalah.

### Pertanyaan API

Galat pertanyaan yang umum dimasukkan kesalahan dan pesan; kode adalah opsional. Galat pengesahan pengesahihan kodeks dapat menggunakan success: false daripada 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 pengurusan

Tanggapan masalah V2 untuk application/problem+json. Tetap jaga requestId untuk dukungan. Kesalahan pengesahan juga dapat mencakup fieldErrors dengan medan, kode dan pesan.

#### 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>

## Periksa status, header, dan badan

Use curl --include untuk melihat ketiganya. Contoh ini memeriksa kunci Anda dengan akun bebas dibaca; tidak mengajukan pertanyaan. FLASHDATA_API_KEY di lingkungan Anda pertama.

### Periksa sebuah respon · 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'
```

- [Persediaan otentikasi Yobel](https://flashdata.dev/ms/docs/guides/headers-and-authentication/reference.md)
- [Peninjau masalah oleh gejala](https://flashdata.dev/ms/docs/guides/troubleshooting/reference.md)

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

## Bila hendak mencoba lagi

POST yang berulang dapat membuat pertanyaan lain yang dapat ditagih. WEVIS Sebuah timeout jaringan tidak membuktikan bahwa permintaan pertama ditolak. Simpan pekerjaan ID segera setelah Anda menerimanya.

| Situasi Orang Asing | Tindakan berikutnya |
| --- | --- |
| Masukan, kunci, izin atau keseimbangan tidak sah | Hentikan. Bioxex memperbaiki keadaan permintaan atau akun sebelum mencoba kembali; jangan loop pada kesalahan ini. |
| 429 dengan petunjuk tunggu | Terison Honor Retry-After (saat atau tanggal HTTP), atau nilai JSON retry_after dalam detik. Jika keduanya hadir, gunakan penundaan yang lebih lama. |
| Permintaan baca lema: 429 / sementara 5xx / error jaringan | Coba lagi GET yang sama. Tanpa petunjuk tunggu, gunakan penundaan yang meningkat dengan ketaran, jumlah percobaan maksimum dan batas waktu. |
| Waktu habis POST atau kabur 5xx | Tetap pertahankan pekerjaan yang sudah ada ID dan periksa statusnya. Jika tidak ada ID diterima, periksa sejarah pekerjaan sebelum memutuskan untuk mengajukan lagi. |

- [Sejarah sejarah sejarah Ayub](https://flashdata.dev/app/jobs)
- [Memulihkan kembali tugas agen](https://flashdata.dev/ms/docs/guides/agent-recovery/reference.md)

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

## Cek latar belakang pekerjaan

HTTP 200 dari titik akhir status berarti pembacaan berhasil. Periksa job.status untuk mengetahui apakah tugas tersebut berhasil. **Ditetapkan* JOB_ID Perintah ini tidak menyerahkan pengganti.

| job.status | Tindakan |
| --- | --- |
| pending / processing | Tunggu, kemudian jajak pendapat pekerjaan yang sama. Hasil result read mengembalikan 409 sampai selesai. |
| completed | Ambil dan simpan hasilnya. Hasil JSON asli mengembalikan 302 penyimpanan pengalihan; hasil yang diformat mengembalikan tubuh secara langsung. |
| failed | Berhenti melakukan polling dan pemeriksaan job.error. Hasil endpoint hasil endpoint mengembalikan 422 dengan kode result_not_ready untuk pekerjaan yang gagal. |

### · 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'
```

- [Periksa status · Python dan cURL](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#status)
- [Hasil yang telah selesai](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#results)
- [Kemajuan pekerjaan Bulk](https://flashdata.dev/ms/docs/reference/bulk-processing/reference.md#getBulkJob)

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

## Kesalahan format-responsi

| Status / kode | Fix |
| --- | --- |
| 400 · unsupported_representation | X-Respond-With untuk markdown, atau buang header. |
| 406 · not_acceptable | Set Accept ke application/json atau text/plain; gunakan UTF-8 jika menspesifikasikan sebuah set karakter. |

- [Contoh format permintaan dan tanggapan](https://flashdata.dev/ms/docs/guides/response-formats/reference.md)

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

## Cari bantuan dengan permintaan

Dia mengirim titik akhir, setem waktu UTC, status HTTP, kode kesalahan dan permintaan atau pekerjaan ID. Hapus kunci API, token dan ditandatangani URLs dari laporan.

- [Hubungi sokongan](https://flashdata.dev/ms/contact)
