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

Интеграции

Варианты аутентификации агента

Подключитесь к ключу API или MCP OAuth, проверьте доступ без платного запроса и повторно используйте его для последующих задач.

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

1. Выберите и соедините

Уже связались? Перейдите прямо к бесплатной проверке на шаге 2. В противном случае выберите доступ к вашему приложению или агенту.

Вы соединяетеИспользоватьКто хранит полномочия?
Приложение, SDK, CLI или запланированный сценарийВладелец ключа APIСекретный магазин вашего сервера или профиль CLI
Инструменты исследования Codex или OpenClawMCP OAuthХост после согласия браузера
Агент, пытающийся взломать FlashData без аккаунтаВременный ключ APIСохраненный профиль агента, а затем доступ владельца после заявления

Создайте ключ в API Keys с источниками, необходимыми для вашей задачи, или повторно используйте существующий ключ. Поставьте его на свой SDK или отправьте его как X-API-Key из вашего бэкэнда. Bash и PowerShell на этапе 2 работают напрямую с API; установка CLI не требуется.

Какие источники могут использовать эту верительные грамоты?

Используйте X-API-Key для обычных запросов HTTP и API-ключ MCP соединений. Токены-носители OAuth работают только на хостинговой конечной точке MCP. YouTube Download нужен ключ API с youtube_download и хранилищем назначения.

ПолномочияДоступные источники
Владелец ключа APIИсточники, предоставленные ключу, в том числе youtube_download при утверждении.
Временный ключ APIТолько разрешённые источники, доступные в пробном режиме. Читайте scopes в текущем ответе проверки личности.
MCP OAuthgoogle_search, youtube_search, youtube_metadata, youtube_transcript

Сохранить ключ в CLI

Пропустите импорт, если у CLI уже есть доступ или ваш секретный менеджер поставляет FLASHDATA_API_KEY. В противном случае выберите метод ниже и сохраните тот же профиль исследования для более поздних команд. Сохраненный ключ CLI недоступен автоматически ни для SDK, ни для локальных серверов MCP.

Вставьте ключ в скрытый терминал.

Импортировать один раз
flashdata auth login --profile research

2. Проверить соединение

Запустите бесплатную проверку в окружающей среде, которая выполнит поставленную задачу. Проверки CLI и HTTP используют ключ API; проверка MCP использует собственное сохраненное соединение хоста.

Требуется 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'
)

Прочитайте ключ API

Поля идентификации HTTP находятся на верхнем уровне. В CLI JSON, прочитайте data.identity.identity и потребуйте data.accessVerified: true. Одного HTTP 200 или CLI ok: true недостаточно.

ПроверитьНеобходимый результат
Предполагаемый счетaccountId и apiKeyId идентифицируют учетную запись и ключ, который вы намеревались использовать.
Удобный доступaccess: ready
Разрешение на заданиеСферы содержат источник, такой как google_search. CLI также содержит список разрешенных источников в data.identity.permittedSources.
Повторяющаяся задачаaccountType: owned · installed: true · recurringAllowed: true

Активное исследование является действительным соединением

Пробный доступ может пройти проверку разовой задачи при recurringAllowed: false. Проверьте фактические разрешения и срок действия; привяжите существующий пробный доступ к аккаунту до настройки расписания.

Временная идентификация · иллюстративные поля
{
  "accountType": "temporary",
  "access": "ready",
  "installed": false,
  "recurringAllowed": false,
  "scopes": [
    "google_search"
  ]
}

Найти соединение в Codex

Перечислите настроенные серверы, а затем используйте /mcp в новой сессии Codex. Запустите проверку MCP выше, чтобы проверить учетные данные.

Список серверов
codex mcp list

Проверьте соединение в OpenClaw

Проверьте сохраненный сервер, а затем запустите проверку MCP выше в вашем активном разговоре.

Проверить сервер
openclaw mcp doctor flashdata --probe

3. Повторное использование доступа для более поздних задач

Держите хранилище учетных данных частным и постоянным при перезапуске процесса. Перепроверьте доступ в новом процессе, прежде чем включить планировщик.

ПолномочияДля следующей задачи
Владелец ключа APIПовторное использование сохраненного ключа. У него нет шага обновления OAuth; замените его, если он истек или отменен.
MCP OAuthХост обновляет одночасовые токены доступа OAuth с помощью вращающихся токенов обновления. Повторное подключение, когда срок действия гранта 90 истекает или аннулируется. Каждая установка имеет свой магазин токенов; не делитесь файлами обновлений между хостами.
Временный ключ APIЗавершите требование владельца и передачу полномочий перед повторной работой. Повторно используйте исходный профиль; не регистрируйтесь повторно для каждого запуска.

Проверьте задачу CLI перед планированием

Требуется Bash и jq. Установите источник для задания. Сценарий использует исследование по умолчанию; установите FLASHDATA_PROFILE и FLASHDATA_STATE_DIR для другого профиля или каталога состояния. Выход 0 с идентификационным номером JSON означает, что ключ владельца готов, установлен и разрешен для этого источника. Пусть ваш планировщик остановится на любом другом выходе. Запрос не подается.

Проверка доступа к новому процессу · Bash
(
set -euo pipefail
SOURCE=google_search
args=(--profile "${FLASHDATA_PROFILE:-research}" --json --non-interactive)
if [[ -n "${FLASHDATA_STATE_DIR:-}" ]]; then
  args+=(--state-dir "$FLASHDATA_STATE_DIR")
fi

flashdata auth status "${args[@]}" |
  jq -e --arg source "$SOURCE" '
    select(.ok == true and .data.accessVerified == true)
    | .data.identity as $auth
    | $auth.identity
    | select(.accountType == "owned" and .access == "ready"
        and .installed == true and .recurringAllowed == true
        and ((.scopes // []) | index($source) != null)
        and (($auth.permittedSources // []) | index($source) != null))
    | {accountId, apiKeyId, scopes, recurringAllowed, expiresAt}'
)

Если доступ все еще является пробным

Завершите испытание и заявляйте руководство с оригинальным профилем. После одобрения владельца и передачи учетных данных, бесплатный чек должен показывать доступ и recurringAllowed: true. Продолжительные запросы используют общий баланс владельца; неиспользованные пробные кредиты не передаются. Логин MCP OAuth является отдельным соединением и не претендует на эту пробную версию.

Отменить доступ

Сначала пауза повторяющихся рабочих мест. Отмените соответствующие учетные данные ниже, а затем повторите бесплатную проверку из нового процесса или сеанса, прежде чем очистить локальный доступ. Ожидайте сбоя аутентификации или запроса на повторное соединение; не одобряйте новое соединение во время проверки. Локальный выход из системы сам по себе не отменяет доступ к серверу.

ПодключениеГде отозвать
MCP OAuthSettings → Connected apps → грант приложения.
Заявленный агент API ключSettings → Connected apps → Агентские соединения.
Ключ APIAPI Keys — ключ, используемый в этой интеграции.

Исправить неудавшийся чек

РезультатМеры
accessVerified: falseЧитать фазу и nextCommand. Отложенный профиль может вернуть ok: true до того, как ключ будет использоваться. Завершите сохраненную регистрацию или заявку; сохраните тот же профиль.
access: blockedОстановитесь, даже если ответ HTTP был 200. Просмотрите учетную запись или соединение в консоли; не рассматривайте ответ на идентификацию как разрешение на запрос.
accountType: temporaryИспользуйте приемлемое испытание для разовой работы. Заявите об этом перед планированием; новое соединение OAuth не претендует на этот профиль.
installed: falseПосле одобрения владельца запустите флеш-данные auth finish --wait с исходным профилем и каталогом состояния. Затем повторите проверку.
401 / invalid_grantВоссоедините просроченные или аннулированные учетные данные в своем первоначальном хосте. Не начинайте еще одно испытание, чтобы обойти его.
403 / source_forbiddenПроверьте области действия ключа или список источников OAuth. YouTube Download использует ключ владельца API.
Действительный доступ, нулевой балансАутентификация работает. Проверьте Billing перед оплаченной работой; не заменяйте действительный ключ.