# 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.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/guides/usage-and-limits
Xem lại: 2026-11-04 by FlashData

<a id="limits"></a>

## 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.

### CLI

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

```bash
flashdata account limits
```

- [Thiết lập phím](https://flashdata.dev/vi/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Yê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.

#### Đặt phím · nhảy qua nếu đã cấu hình rồi

```bash
# 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
```

#### Tài khoản đọc JSON

```bash
(
: "${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'
)
```


### PowerShell 7

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.

#### Đặt phím · nhảy qua nếu đã cấu hình rồi

```powershell
# 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
```

#### Tài khoản đọc JSON

```powershell
& {
  $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
}
```



<a id="capacity"></a>

### 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. |

- [Giới hạn đăng ký thử nghiệm](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md#trial-limits)

<a id="rate-limit"></a>

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

```bash
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
```


<a id="retry-example"></a>

### Đợ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
HTTP/1.1 429 Too Many Requests
Retry-After: 60
```


<a id="retry-actions"></a>

### Chọ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õ. |

- [Phục hồi tác vụ bị ngắt quãng](https://flashdata.dev/vi/docs/guides/agent-recovery/reference.md)

<a id="usage"></a>

## Đọ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.

### CLI

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

```bash
flashdata account usage
```

- [Thiết lập phím](https://flashdata.dev/vi/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

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.

#### Tài khoản đọc JSON

```bash
(
: "${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'
)
```


### PowerShell 7

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.

#### Tài khoản đọc JSON

```powershell
& {
  $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
}
```



<a id="usage-result"></a>

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

```json
{
  "scope": "account_authorized_sources",
  "unit": "Credits",
  "totals": {
    "requests": 5,
    "completed": 5,
    "failed": 0,
    "credits": 0.1
  }
}
```

- [Xem xét một công việc trong History](https://flashdata.dev/app/jobs)
- [Hiểu tội trạng](https://flashdata.dev/vi/docs/guides/credits-and-billing/reference.md)

<a id="usage-filter"></a>

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

```bash
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"
```

