Перейти к содержимому
RU
Ключ API
Обзор документации

Начало работы

Ограничения по ставкам и использование

Проверить емкость счета, отреагировать на лимиты ставок и отслеживать выполненную работу.

На этой странице

Проверьте свои пределы

Ограничения следуют за вашим счетом и планом. Запустите эту бесплатную проверку с помощью ключа, который предоставит работу; все ключи на счете имеют одинаковую емкость.

Используйте сохраненный доступ CLI. Для именованного профиля добавьте имя --profile к каждой команде. Эти чтения не тратят кредиты на запросы.

Бесплатный аккаунт читать
flashdata account limits

Понять каждый предел

Начните с одного запроса в полете, а затем увеличьте его в пределах заявленных лимитов. HTTP считывают конечные точки, а регистрация пробных версий также имеет свои собственные ограничения по ставкам; эти поля емкости не являются квотами на запросы в минуту.

ПолеЗначение
limits.concurrencyПланируйте потолок для одновременной работы, а не подсчет свободных слотов.
limits.batchSizeМаксимальные пункты в одной партии представления.
limits.pendingJobsМаксимально отложенные рабочие места на счету.
current.pendingJobsВ ожидании подсчета во время чтения. Он может быть изменен до подачи.

Обработка ответа 429

Прочитайте тело ошибки и заголовок Retry-After. Чтобы проверить бесплатную учетную запись, запустите ее в терминале Bash, где установлен FLASHDATA_API_KEY. Заголовки написаны на limits-headers.txt и ответ на limits.json.

Статус захвата, заголовки и тело · Bash / cURL
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

Проверить выполненные работы и кредиты

Прочитайте итоговые данные и 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"