Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Mulai

Batas rate dan penggunaan

Inspeksi kapasitas akun, menanggapi batas kecepatan dan jalur pekerjaan selesai.

Di halaman ini

Periksa batasanmu

Batas-batas mengikuti account dan rencana. Jalankan pemeriksaan gratis ini dengan kunci yang akan mengirimkan pekerjaan; semua kunci pada akun berbagi kapasitas yang sama.

Gunakan disimpan Anda CLI Akses. Untuk profil bernama, tambahkan --profile NAMA ke setiap perintah. Baca ini jangan menghabiskan kredit query.

Rekening bebas dibaca
flashdata account limits

Memahami batas masing-masing

Mulailah dengan satu permintaan in- penerbangan, kemudian meningkatkan dalam batas laporan. HTTP membaca titik akhir dan pendaftaran pengadilan juga memiliki batas tingkat sendiri; bidang kapasitas ini tidak diperlukan - kuota per menit.

RuasArtinya
limits.concurrencyRencana langit-langit untuk pekerjaan simultan, bukan hitungan slot bebas.
limits.batchSizeButir maksimum dalam satu pengiriman batch.
limits.pendingJobsMaksimum menunggu pekerjaan untuk account.
current.pendingJobsPenundaan menghitung pada saat membaca. Ini bisa berubah sebelum penyerahan.

Tangani respon 429

Baca tubuh galat dan header Retry-After. Untuk memeriksa akun yang dibaca gratis, jalankan ini di terminal Bash dimana FLASHDATA_API_KEY diatur. Header ditulis ke limits-headers.txt dan respon terhadap limits.json.

Menangkap status, tajuk dan tubuh Bash / cURL
curl --silent --show-error --max-time 20 \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}" \
  --dump-header limits-headers.txt --output limits.json \
  --write-out 'HTTP %{http_code}\n' \
  https://api.flashdata.dev/v2/api-access/limits
cat limits-headers.txt limits.json

Tunggu sebelum mencoba lagi

Contoh ini berarti tunggu setidaknya 60 detik. Retry-After bisa juga menjadi HTTP Kencan. Gunakan nilai kembali, bukan penundaan tetap.

Header respon Illustratif
HTTP/1.1 429 Too Many Requests
Retry-After: 60

Pilih aksi berikutnya

SituasiAksi
Kapasitas penuhMengurangi konkuensi atau menunggu pekerjaan yang tertunda untuk finish.
Tidak ada Retry-AfterGunakan backed off dengan jitter dan batas pengulangan terbatas.
Pendaftaran terbatasTunggu, coba lagi dengan profil, masukan dan bukti yang sama. Jangan beralih IP.
Waktu submisi habisInspeksi run atau pekerjaan yang telah ada sebelum mengajukan kembali; hasilnya tidak diketahui.

Baca penggunaan akun

Jendela baku adalah tujuh hari terakhir. Penggunaan mencakup semua kunci akun, dibatasi ke sumber yang kunci ini dapat mengakses.

Gunakan disimpan Anda CLI Akses. Untuk profil bernama, tambahkan --profile NAMA ke setiap perintah. Baca ini jangan menghabiskan kredit query.

Rekening bebas dibaca
flashdata account usage

Periksa pekerjaan dan kredit yang selesai

Baca total dan bySource, kemudian bandingkan dari dan ke dengan catatan tugas Anda. CLI JSON membungkus respon dalam data. Permintaan atau pengembalian dana baru-baru ini dapat mengambil waktu untuk muncul, bahkan ketika memperbarui adalah false.

Excerpt respon Illustratif
{
  "scope": "account_authorized_sources",
  "unit": "Credits",
  "totals": {
    "requests": 5,
    "completed": 5,
    "failed": 0,
    "credits": 0.1
  }
}

Filter kisaran sumber dan tanggal

Ganti tanggal UTC dengan periode pelaporan Anda, hingga hari 31. Dari inklusif dan sampai eksklusif; keduanya dibulatkan ke menit. Ini hanya membaca penggunaan yang ada.

Contoh jendela pelaporan
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"