Chuyển đến nội dung
VI
Lấy khóa API
Duyệt tài liệu

Bắt đầu

Tỷ lệ giới hạn và sử dụng

Kiểm tra khả năng tài khoản, đáp ứng với giới hạn tốc độ và theo dõi hoàn thành công việc.

Trên trang này

Kiểm tra lại giới hạn đi

Giới hạn theo dõi tài khoản và kế hoạch của bạn. Hãy chạy tự do kiểm tra với chìa khóa để đệ trình công việc; tất cả các phím trong tài khoản đều có cùng một khả năng.

Sử dụng khả năng truy cập CLI đã lưu. Đối với một hồ sơ tên, phụ --profile NAME cho mỗi lệnh. Những câu này không dùng các tài liệu truy vấn.

Tài khoản miễn phí đọc
flashdata account limits

Hiểu mỗi giới hạn

Bắt đầu với yêu cầu bay, sau đó tăng trong giới hạn báo cáo. HTTP đọc điểm cuối và đăng ký thử nghiệm cũng có giới hạn của riêng họ; những trường dung tích này không phải là chỉ tiêu-một phút.

Tìm kiếmNghĩa là
limits.concurrencyLên kế hoạch trần nhà cho công việc đồng thời, không phải là một đếm các khe trống.
limits.batchSizeThư mục tối đa trong một hàng trình nộp.
limits.pendingJobsCông việc đang đợi tối đa cho tài khoản.
current.pendingJobsĐếm ngược vào thời điểm đọc. Nó có thể thay đổi trước khi phục tùng.

Xử lý một phản ứng 429

Đọc các lỗi cơ thể và Retry-After Đầu trang. Để kiểm tra một tài khoản miễn phí đọc, chạy điều này trong một Bash trạm cuối nơi FLASHDATA_API_KEY đã được thiết lập. Tiêu đề được viết bằng limits-headers.txt và phản ứng của limits.json.

Chụp tình trạng, đầu đề và cơ thể . 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

Đợi trước khi thử lại

Ví dụ này có nghĩa là ít nhất chờ đợi 60 giây. Retry-After cũng có thể là một ngày HTTP. Sử dụng giá trị trả về, không phải là sự chậm trễ cố định.

Đầu đề phản ứng giả định
HTTP/1.1 429 Too Many Requests
Retry-After: 60

Chọn hành động tiếp theo

Tình trạngHành động
Độ bền đầyGiảm bớt sự nhất trí hoặc chờ đợi công việc đến finish.
Không Retry-AfterDùng từ lùi có kích thích và giới hạn thử lại hữu hạn.
Hạn chế đăng kýĐợi đã, sau đó thử lại với cùng một hồ sơ, đầu vào và chứng minh. Đừng đổi IP.
Đã quá giờXem xét lại việc chạy hoặc công việc đã có trước khi phục hồi lại; kết quả của nó là không rõ.

Đọc cách sử dụng tài khoản

Cửa sổ mặc định là bảy ngày cuối cùng. Sử dụng mọi khoá tài khoản, bị hạn chế vào các nguồn mà phím này có thể truy cập.

Sử dụng khả năng truy cập CLI đã lưu. Đối với một hồ sơ tên, phụ --profile NAME cho mỗi lệnh. Những câu này không dùng các tài liệu truy vấn.

Tài khoản miễn phí đọc
flashdata account usage

Kiểm tra công việc và tín dụng hoàn tất

Đọc tổng cộng và bySource, sau đó so sánh từ và với hồ sơ nhiệm vụ của bạn. CLI JSON bọc các phản ứng trong dữ liệu. Những yêu cầu hoặc hoàn trả lại gần đây có thể mất thời gian để xuất hiện, ngay cả khi cập nhật là false.

Phần trả lời tưởng tượng
{
  "scope": "account_authorized_sources",
  "unit": "Credits",
  "totals": {
    "requests": 5,
    "completed": 5,
    "failed": 0,
    "credits": 0.1
  }
}

Lọc một phạm vi ngày tháng và nguồn

Thay thế ngày tháng UTC bằng thời gian báo cáo của bạn, đến 31 ngày. từ bao gồm và cho đến nay là độc quyền; cả hai được tập trung lại đến phút. Đây là chỉ đọc cách sử dụng tồn tại.

Ví dụ cho cửa sổ đang báo cáo
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"