Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Rujukan API

Ralat dan kod status

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

Pada halaman ini

Kode status HTTP

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

StatusArtiTindakan
400Permintaan tidak sahBaiki sumber, bidang yang diperlukan, parameter jenis atau header respon sebelum dicoba lagi.
401Otentikasi Autentikasi gagalPeriksa X-API-Key. Megantikan sebuah kunci yang sudah kadaluarsa atau dicabut; mencoba lagi kunci yang sama tidak akan membantu.
402Kredit tidak mencukupiPeriksa saldo rekening. Tambahkan kredit atau biarkan pemilik akun menyelesaikan akses sebelum mengajukan lagi.
403Akses ditolakPeriksa hak dan akun sumber kunci atau status langganan.
404Tidak ditemukanPeriksa URL, pekerjaan ID dan akun. Pekerjaan di luar akun atau sumber yang Anda ijinkan juga dapat mengembalikan 404.
406Tipe respon tidak dapat diterimaGuna Accept: application/json OR atau ORANG text/plain. Pilih Markdown dengan X-Respond-With: markdown.
409Hasil tidak siap / konflikPada hasil yang dibaca, jajak pendapat pekerjaan yang ada sampai selesai. Untuk titik akhir lainnya, selesaikan konflik yang dijelaskan dalam tubuh.
410Hasil Hasil panen tamat tempohGuna salinan yang disimpan. Cabut kembali hasil URL tidak dapat memulihkan hasil yang sudah habis.
422Input 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.
429Batas tercapaiTunggu Retry-After atau retry_after. Kurangi tingkat permintaan; untuk antrian tertunda penuh, tunggu untuk pekerjaan yang ada ke finish.
500 / 502 / 503 / 504Layanan dan kegagalan huluKau mencoba membaca dengan backoff terikat. Untuk POST atau submission timeout, periksa apakah pekerjaan diterima sebelum mengirimkannya lagi.

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.

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
{
  "error": true,
  "code": "unsupported_representation",
  "message": "X-Respond-With supports markdown. Omit the header for the original result fields."
}

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

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 AsingTindakan berikutnya
Masukan, kunci, izin atau keseimbangan tidak sahHentikan. Bioxex memperbaiki keadaan permintaan atau akun sebelum mencoba kembali; jangan loop pada kesalahan ini.
429 dengan petunjuk tungguTerison 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 jaringanCoba lagi GET yang sama. Tanpa petunjuk tunggu, gunakan penundaan yang meningkat dengan ketaran, jumlah percobaan maksimum dan batas waktu.
Waktu habis POST atau kabur 5xxTetap pertahankan pekerjaan yang sudah ada ID dan periksa statusnya. Jika tidak ada ID diterima, periksa sejarah pekerjaan sebelum memutuskan untuk mengajukan lagi.

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.statusTindakan
pending / processingTunggu, kemudian jajak pendapat pekerjaan yang sama. Hasil result read mengembalikan 409 sampai selesai.
completedAmbil dan simpan hasilnya. Hasil JSON asli mengembalikan 302 penyimpanan pengalihan; hasil yang diformat mengembalikan tubuh secara langsung.
failedBerhenti melakukan polling dan pemeriksaan job.error. Hasil endpoint hasil endpoint mengembalikan 422 dengan kode result_not_ready untuk pekerjaan yang gagal.
· cURL / 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'

Kesalahan format-responsi

Status / kodeFix
400 · unsupported_representationX-Respond-With untuk markdown, atau buang header.
406 · not_acceptableSet Accept ke application/json atau text/plain; gunakan UTF-8 jika menspesifikasikan sebuah set karakter.

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.