Duyệt tài liệu
Bắt đầu
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.
flashdata account limitsYêu cầu Bash và cURL 7.76+. Bỏ qua dấu nhắc phím bị ẩn nếu môi trường của bạn đã cung cấp FLASHDATA_API_KEY. Chạy lệnh đọc trong cùng một thiết bị cuối.
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/api-access/limits' || exit
printf '\n'
)Bỏ qua dấu nhắc khoá bị ẩn nếu FLASHDATA_API_KEY đã được thiết lập. Chạy lệnh đọc trong cùng một thiết bị cuối.
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey& {
$ErrorActionPreference = 'Stop'
if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
throw 'Set FLASHDATA_API_KEY first'
}
$flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
$flashdataBase = 'https://api.flashdata.dev/v2'
$flashdataUri = "$flashdataBase/api-access/limits"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}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ếm | Nghĩa là |
|---|---|
| limits.concurrency | Lê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.batchSize | Thư mục tối đa trong một hàng trình nộp. |
| limits.pendingJobs | Cô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.
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.
HTTP/1.1 429 Too Many Requests
Retry-After: 60Chọn hành động tiếp theo
| Tình trạng | Hành động |
|---|---|
| Độ bền đầy | Giảm bớt sự nhất trí hoặc chờ đợi công việc đến finish. |
| Không Retry-After | Dù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.
flashdata account usageDùng lại FLASHDATA_API_KEY từ lần kiểm tra trước trong cùng một thiết bị cuối.
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/usage' || exit
printf '\n'
)Dùng lại FLASHDATA_API_KEY từ lần kiểm tra trước trong cùng một thiết bị cuối.
& {
$ErrorActionPreference = 'Stop'
if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
throw 'Set FLASHDATA_API_KEY first'
}
$flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
$flashdataBase = 'https://api.flashdata.dev/v2'
$flashdataUri = "$flashdataBase/usage"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}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.
{
"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.
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"