# Kesalahan dan kode status

Cari penyebab dari permintaan yang gagal dan putuskan apakah akan memperbaikinya, tunggu atau coba lagi.

Referensi kanonikal: https://flashdata.dev/id/docs/errors
Diulang: 2026-11-04 oleh FlashData

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

## HTTP kode status

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

| Status | Artinya | Yang perlu dilakukan |
| --- | --- | --- |
| 400 | Permintaan tidak valid | Perbaiki sumber, ruas yang diperlukan, tipe parameter atau tajuk respon sebelum mencoba kembali. |
| 401 | Otentikasi gagal | Periksa X-API-Key. Ganti kunci yang kadaluwarsa atau dicabut; mencoba ulang kunci yang sama tidak akan membantu. |
| 402 | Kredit tidak mencukupi | Periksa saldo rekening. Tambahkan kredit atau biarkan pemilik akun meresolf akses sebelum mengirimkan lagi. |
| 403 | Akses ditolak | Periksa izin sumber kunci dan akun atau status berlangganan. |
| 404 | Tidak ditemukan | Periksa URL, kerja ID dan rekening. Jobs di luar akun atau sumber yang diizinkan Anda juga dapat kembali 404. |
| 406 | Tipe respon tidak dapat diterima | Gunakan Accept: application/json atau 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, menyelesaikan konflik yang dijelaskan dalam tubuh. |
| 410 | Hasil kadaluarsa | Gunakan salinan tersimpan. Mencoba kembali hasil URL tidak dapat mengembalikan hasil yang telah kadaluarsa. |
| 422 | Pekerjaan masukan / gagal tidak valid | Perbaiki area laporan. Pada hasil membaca, memeriksa job.error: pekerjaan gagal tidak memiliki hasil sukses untuk mengambil. |
| 429 | Batas tercapai | Tunggu Retry-After atau retry_after. Kurangi laju permintaan; untuk antrian yang tertunda, tunggu tugas yang telah ada ke finish. |
| 500 / 502 / 503 / 504 | Layanan atau upstream gagal | Coba baca lagi dengan latar belakang yang padat. Untuk POST atau waktu pengajuan, periksa apakah pekerjaan diterima sebelum mengirimkannya lagi. |

- [Periksa kunci API](https://flashdata.dev/app/api-keys)
- [Kredit dan harga](https://flashdata.dev/id/docs/guides/credits-and-billing/reference.md)
- [Batas rate](https://flashdata.dev/id/docs/guides/usage-and-limits/reference.md)

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

## Baca sebuah respon galat

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

### Query API

Query error umumnya termasuk kesalahan dan pesan; kode adalah opsional. Galat otentikasi 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."
}
```


### Manajemen API

Masalah V2 respon menggunakan application/problem+json. Jaga requestId untuk dukungan. Validasi error juga dapat menyertakan fieldErrors dengan field, 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>

## Inspeksi status, header, dan tubuh

Gunakan curl --include untuk melihat ketiganya. Contoh ini memeriksa kunci Anda dengan membaca akun gratis; ini tidak mengirimkan permintaan. Set FLASHDATA_API_KEY di lingkungan Anda terlebih dahulu.

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

- [Pengaturan otentikasi](https://flashdata.dev/id/docs/guides/headers-and-authentication/reference.md)
- [Troubleshoot oleh gejala](https://flashdata.dev/id/docs/guides/troubleshooting/reference.md)

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

## Kapan untuk mencoba lagi

POST yang berulang dapat membuat kueri yang lain. Tenggat jaringan tidak membuktikan bahwa permintaan pertama ditolak. Simpan pekerjaan ID segera setelah Anda menerimanya.

| Situasi | Aksi berikutnya |
| --- | --- |
| Masukan, kunci, izin, atau keseimbangan tidak valid | Berhenti. Perbaiki keadaan permintaan atau akun sebelum mencoba ulang; jangan loop pada galat ini. |
| 429 dengan petunjuk tunggu | Kehormatan Retry-After (detik atau HTTP tanggal), atau JSON retry_after nilai dalam detik. Jika keduanya hadir, gunakan penundaan yang lebih lama. |
| Permintaan baca: 429 / sementara 5xx / network error | Coba GET yang sama. Tanpa petunjuk tunggu, gunakan meningkatnya penundaan dengan jitter, jumlah percobaan maksimum dan batas waktu. |
| POST timeout atau ambigu 5xx | Pertahankan pekerjaan yang ada ID dan periksa statusnya. Jika tidak ada ID yang diterima, pemeriksaan sejarah pekerjaan sebelum memutuskan untuk mengirimkan lagi. |

- [Riwayat tugas](https://flashdata.dev/app/jobs)
- [Mengambil alih tugas agen](https://flashdata.dev/id/docs/guides/agent-recovery/reference.md)

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

## Periksa pekerjaan latar belakang

HTTP 200 dari titik akhir status berarti membaca berhasil. Periksa job.status untuk mengetahui apakah tugas tersebut berhasil. Set JOB_ID untuk pekerjaan Anda yang ada; perintah ini tidak mengirimkan pengganti.

| job.status | Yang perlu dilakukan |
| --- | --- |
| pending / processing | Tunggu, lalu melakukan polling dengan pekerjaan yang sama. Hasil membaca 409 sampai selesai. |
| completed | Ambil dan simpan hasilnya. JSON asli menghasilkan sebuah penyimpanan 302 direk; hasil terformat mengembalikan tubuh secara langsung. |
| failed | Berhenti polling dan periksa job.error. Hasil akhir mengembalikan 422 dengan kode result_not_ready untuk pekerjaan yang gagal. |

### Baca status pekerjaan 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/id/docs/reference/realtime-and-async/reference.md#status)
- [Mengambil hasil selesai](https://flashdata.dev/id/docs/reference/realtime-and-async/reference.md#results)
- [Bulk kemajuan pekerjaan](https://flashdata.dev/id/docs/reference/bulk-processing/reference.md#getBulkJob)

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

## Kesalahan format responsa-

| Status / kode | Perbaiki |
| --- | --- |
| 400 · unsupported_representation | Set X-Respond-With ke markdown, atau hapus header. |
| 406 · not_acceptable | Set Accept ke application/json atau text/plain; gunakan UTF-8 jika menyatakan charset. |

- [Permohonan dan contoh format respon](https://flashdata.dev/id/docs/guides/response-formats/reference.md)

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

## Dapatkan bantuan dengan permintaan

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

- [Hubungi dukungan](https://flashdata.dev/id/contact)
