# อัตราจํากัดและการใช้งาน

ความจุของบัญชีที่เจาะจง, ตอบสนองกับอัตราการจํากัดและเพลงที่เสร็จ

อ้างอิงทางคลอง: https://flashdata.dev/th/docs/guides/usage-and-limits
Recorder: 2026-11-04 โดย FlashData

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

## ตรวจ ขีด จํากัด ของ คุณ

จํากัดตามบัญชีของคุณ และแผนการ เรียกใช้การตรวจสอบนี้ฟรีด้วยกุญแจที่จะส่งงาน; กุญแจทั้งหมดบนบัญชีผู้ใช้ จะใช้ร่วมกัน

### CLI

ใช้สิทธิ์ CLI ของคุณ สําหรับโพรไฟล์ชื่อ ผนวก --profile ชื่อแต่ละคําสั่ง หนังสือ เหล่า นี้ ไม่ ได้ ใช้ จ่าย เงิน ตรา.

#### อ่านบัญชีผู้ใช้อิสระ

```bash
flashdata account limits
```

- [ตั้งค่าคีย์](https://flashdata.dev/th/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

ต้องการ Bash ถึง cURL 7.76+. ข้ามการแจ้งเตือนคีย์ที่ซ่อน หากสภาพแวดล้อมของคุณอยู่แล้วให้บริการ FLASHDATA_API_KEY ประมวลผลคําสั่งอ่านในเทอร์มินัลเดียวกัน

#### ตั้งค่าปุ่มพิมพ์ ski ถ้าได้ปรับแต่งไว้แล้ว

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

#### บัญชีผู้ใช้ที่อ่านแล้ว 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

ข้ามปุ่มที่ซ่อน ถ้า FLASHDATA_API_KEY ได้ตั้งค่าแล้ว ประมวลผลคําสั่งอ่านในเทอร์มินัลเดียวกัน

#### ตั้งค่าปุ่มพิมพ์ ski ถ้าได้ปรับแต่งไว้แล้ว

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

#### บัญชีผู้ใช้ที่อ่านแล้ว 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>

### เข้าใจค่าลิมิตแต่ละค่า

เริ่มด้วยคําร้องขอแบบ In-fight แล้วเพิ่มในข้อจํากัดที่ได้รับรายงาน HTTP อ่านจุดปลายและลงทะเบียนการทดลองยังมีอัตราการจํากัดของตัวเอง; สนามเหล่านี้ไม่ได้ร้องขอโควตาต่อนาที

| ช่องข้อมูล | หมายความว่า |
| --- | --- |
| limits.concurrency | วางแผนเพดานสําหรับการทํางานพร้อมกันไม่ได้นับของช่องฟรี |
| limits.batchSize | รายการสูงสุดในการส่งข้อมูลแบบชุดเดียว |
| limits.pendingJobs | งานที่ค้างชําระสูงสุดสําหรับบัญชี |
| current.pendingJobs | นับครั้งที่อ่านแล้ว มันสามารถเปลี่ยนแปลงได้ ก่อนที่จะยอมจํานน |

- [จํากัดการลงทะเบียนแบบทดสอบ](https://flashdata.dev/th/docs/guides/agent-onboarding/reference.md#trial-limits)

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

## จัดการ 429 ตอบกลับ

อ่านตัวผิดพลาดและ Retry-After ส่วนหัว เพื่อตรวจสอบการอ่านบัญชีฟรี, ดําเนินการนี้ใน Bash เทอร์มินัลที่ FLASHDATA_API_KEY เรียบร้อย ส่วนหัวจดหมายถูกเขียนไปยัง limits-headers.txt และการตอบรับ limits.json.

### สถานะการจับภาพ, headers and body eth 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>

### รอก่อนที่จะลองใหม่

ตัวอย่างนี้หมายถึง รออย่างน้อย 60 วินาที Retry-After อาจเป็น HTTP เดท ใช้ค่าคืน ไม่ใช่การหน่วงที่คงที่

#### หัวจดหมายแบบผุด

```http
HTTP/1.1 429 Too Many Requests
Retry-After: 60
```


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

### เลือกการกระทําถัดไป

| สถานการณ์ | การกระทํา |
| --- | --- |
| ความจุเต็ม | ลดความเหลื่อมล้ํา หรือรองานค้าง finish. |
| ไม่มี Retry-After | ใช้ส่วนท้ายแบบแหลมๆ กับค่าจํากัดของเส้นพริ้วไหว |
| จํากัดการลงทะเบียน | เดี๋ยว, แล้วลองใหม่ด้วยโปรไฟล์เดียวกัน, การป้อนข้อมูลและข้อพิสูจน์ อย่าสลับ IP |
| หมดเวลาการรับส่งข้อมูลแล้ว | จําแนกการทํางานหรืองานที่มีอยู่ก่อนทําการแทนที่; ผลของมันไม่ทราบ |

- [เรียกคืนงานที่ขัดจังหวะ](https://flashdata.dev/th/docs/guides/agent-recovery/reference.md)

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

## อ่านการใช้บัญชีผู้ใช้

หน้าต่างปริยายคือ 7 วันสุดท้าย การใช้ครอบคลุมกุญแจบัญชีผู้ใช้ทั้งหมด ถูกจํากัดด้วยแหล่งที่กุญแจนี้เข้าถึงได้

### CLI

ใช้สิทธิ์ CLI ของคุณ สําหรับโพรไฟล์ชื่อ ผนวก --profile ชื่อแต่ละคําสั่ง หนังสือ เหล่า นี้ ไม่ ได้ ใช้ จ่าย เงิน ตรา.

#### อ่านบัญชีผู้ใช้อิสระ

```bash
flashdata account usage
```

- [ตั้งค่าคีย์](https://flashdata.dev/th/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

ใช้อีกครั้ง FLASHDATA_API_KEY จากการตรวจสอบก่อนหน้านี้ ในอาคารเดียวกัน

#### บัญชีผู้ใช้ที่อ่านแล้ว 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

ใช้อีกครั้ง FLASHDATA_API_KEY จากการตรวจสอบก่อนหน้านี้ ในอาคารเดียวกัน

#### บัญชีผู้ใช้ที่อ่านแล้ว 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>

### ตรวจสอบการทํางานและเครดิตที่เสร็จสมบูรณ์

อ่านรวมทั้งหมด และ bySource จากนั้นให้เปรียบเทียบจากและกับบันทึกงานของคุณ CLI JSON ครอบคลุมการตอบกลับในข้อมูล การร้องขอหรือการคืนเงินอาจจะใช้เวลาในการปรากฏตัว แม้เมื่อการปรับปรุงเป็น false

#### การตอบสนองแบบสะท้อนแสง

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

- [เลือกงานใน History](https://flashdata.dev/app/jobs)
- [เข้าใจข้อกล่าวหา](https://flashdata.dev/th/docs/guides/credits-and-billing/reference.md)

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

### กรองช่วงของแหล่งและวันที่

แทนที่วันที่ UTC ด้วยช่วงเวลารายงานของคุณถึง 31 วัน. จาก นั้น ก็ จะ มี การ แบ่ง แยก เป็น กลุ่ม ๆ และ ใช้ เวลา โดย เฉพาะ; ทั้ง สอง ช่วง จะ ถูก แบ่ง ออก เป็น นาที. การอ่านนี้ใช้ได้กับผู้ใช้เท่านั้น

#### ตัวอย่างรายงานหน้าต่าง

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

