Переглянути документацію
Початок роботи
Перевірка працездатності облікового запису, реагування на ліміти тарифів та контроль виконання робіт.
На цій сторінці
Перевірити ліміти
Виконайте реєстрацію та підписку на обліковий запис. Запустіть цю безкоштовну перевірку з ключем, який буде подавати роботу; всі ключі на рахунок, що діляться однаковою ємністю.
Використовуйте ваш збережений CLI access. Для названого профілю, Додаток --profile NAME до кожного команди. Ці дані не витрачають на запити.
flashdata account limitsВимагає Bash і cURL 7.76+. Випробуйте приховану клавішу підказки, якщо ваше оточення вже постачає FLASHDATA_API_KEY. Виконайте дані команди в одному терміналі.
# 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'
)Запустіть приховану клавішу, якщо FLASHDATA_API_KEY вже встановлена. Виконайте дані команди в одному терміналі.
# 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
}Підтримувати кожен ліміт
Почніть з одного активного запиту й поступово збільшуйте їхню кількість у межах отриманих лімітів. HTTP endpoint для читання та реєстрація пробного доступу мають окремі обмеження частоти; ці поля місткості не є квотами запитів на хвилину.
| Поле | Зручності |
|---|---|
| limits.concurrency | Планувати стелю для одночасної роботи, не кількість вільних слотів. |
| limits.batchSize | Максимальні елементи в одному пакетному подачі. |
| limits.pendingJobs | Максимальні робочі місця для рахунку. |
| current.pendingJobs | Прикінчення підрахунку в часі читання. Перед подачею можна змінити. |
Відповідність 429
Читати корпус помилки та заголовок Retry-After Для перегляду вільного облікового запису, запустіть це в терміналі Bash, де встановлюється FLASHDATA_API_KEY. Заголовки написані на limits-headers.txt і відповідь на 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Очікується до птиху
Цей приклад означає очікування принаймні 60 секунд. Retry-After також може бути дата HTTP. Використовуйте повернуті значення, не зафіксовано затримку.
HTTP/1.1 429 Too Many Requests
Retry-After: 60Виберіть наступну дію
| Ситуація | Дія |
|---|---|
| Місткість повного | Знижувати конваси або чекати закінчення робочих місць до finish. |
| Ні Retry-After | Використовуйте застібку з джиттером і скінченним обмеженням птиця. |
| Реєстрація обмежена | Очікується, потім птиця з тим же профільом, входом і вистоюванням. Не переключайте IP-адреси. |
| Відхилений термін дії | Ознайомтеся з існуючим запуском або роботою перед переадресацією; його результат невідомий. |
Використання облікового запису
Вікно за замовчуванням - останні сім днів. Використання охоплює всі ключі облікового запису, обмежені джерелами, які можуть отримати доступ до цього ключа.
Використовуйте ваш збережений CLI access. Для названого профілю, Додаток --profile NAME до кожного команди. Ці дані не витрачають на запити.
flashdata account usageЗапобігти 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/usage' || exit
printf '\n'
)Запобігти FLASHDATA_API_KEY з попередньою перевіркою в одному терміналі.
& {
$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
}Перевірити завершені роботи та кредити
Прочитати загальні та bySource, потім порівняти з та з вашими записами завдань. CLI JSON обгортає відповідь в даних. Недавні запити або повернення коштів можуть зайняти час, щоб з'явитися навіть при оновленні false.
{
"scope": "account_authorized_sources",
"unit": "Credits",
"totals": {
"requests": 5,
"completed": 5,
"failed": 0,
"credits": 0.1
}
}Фільтрувати джерело і діапазон дати
Замініть дати UTC з вашим звітним періодом, до 31 днів. з інклюзивно і до ексклюзивних; обидва закруглені до хвилини. Це тільки наявне використання.
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"