Обзор документации
Начало работы
Проверить емкость счета, отреагировать на лимиты ставок и отслеживать выполненную работу.
На этой странице
Проверьте свои пределы
Ограничения следуют за вашим счетом и планом. Запустите эту бесплатную проверку с помощью ключа, который предоставит работу; все ключи на счете имеют одинаковую емкость.
Используйте сохраненный доступ CLI. Для именованного профиля добавьте имя --profile к каждой команде. Эти чтения не тратят кредиты на запросы.
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 считывают конечные точки, а регистрация пробных версий также имеет свои собственные ограничения по ставкам; эти поля емкости не являются квотами на запросы в минуту.
| Поле | Значение |
|---|---|
| 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. Для именованного профиля добавьте имя --profile к каждой команде. Эти чтения не тратят кредиты на запросы.
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"