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

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

Заголовки и аутентификация

Используйте правильный хост и учётные данные, затем проверьте доступ одним бесплатным запросом.

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

База URLs

ЦельБаза URLАутентификация
Запросы данных и рабочие местаhttps://data.flashdata.dev/v1X-API-Key
Идентичность, баланс, цены, ограничения и использованиеhttps://api.flashdata.dev/v2X-API-Key
Удаленный MCPhttps://data.flashdata.dev/mcpУправляемый хостом OAuth, или X-API-Key

Заголовки аутентификации

Запросы REST используют X-API-Key с пробным ключом или ключом владельца. Отправка тел JSON с помощью Content-Type: application/json. Профили CLI, среды SDK и соединения MCP хранят учетные данные отдельно.

Запросить заголовки
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json

Проверьте свой ключ

Запустите это в терминале. Конечная точка идентификации проверяет доступ без расходования кредитов. Пропустите подсказку ключа, если FLASHDATA_API_KEY уже установлен.

Требуется 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
Прочитать аккаунт JSON
(
: "${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/identity' || exit
printf '\n'
)

Ожидаемый ответ

Ожидать HTTP 200. Проверьте предполагаемую учетную запись, access: ready и ваш источник в областях. Временный ключ имеет accountType: temporary; для работы с постоянным владельцем требуется recurringAllowed: true.

Идентификация владельца · иллюстративный ответ
{
  "accountId": "acc_example",
  "apiKeyId": "key_example",
  "accountType": "owned",
  "access": "ready",
  "scopes": [
    "google_search"
  ],
  "recurringAllowed": true
}

Подписанное хранилище URLs

Результат и загрузка URLs включают в себя их собственное разрешение. Следите за возвращенным URL без X-API-Key, токенов OAuth или файлов cookie браузера.

Устранение неполадок в аутентификации

ОтветСледующий шаг
401Проверьте ключ в этой среде, его истечение и отзыв. Используйте текущий ключ API, а не токен MCP или префикс Bearer.
403/Источник отсутствуетПопросите владельца предоставить необходимый источник для этого ключа.
503 в этом бесплатном чтенииПовторите прочитанное позже. Статус учетной записи не был проверен; не делайте вывод о том, что платный запрос готов.