Обзор документации
Интеграции
Подключитесь к ключу API или MCP OAuth, проверьте доступ без платного запроса и повторно используйте его для последующих задач.
На этой странице
1. Выберите и соедините
Уже связались? Перейдите прямо к бесплатной проверке на шаге 2. В противном случае выберите доступ к вашему приложению или агенту.
| Вы соединяете | Использовать | Кто хранит полномочия? |
|---|---|---|
| Приложение, SDK, CLI или запланированный сценарий | Владелец ключа API | Секретный магазин вашего сервера или профиль CLI |
| Инструменты исследования Codex или OpenClaw | MCP OAuth | Хост после согласия браузера |
| Агент, пытающийся взломать FlashData без аккаунта | Временный ключ API | Сохраненный профиль агента, а затем доступ владельца после заявления |
Создайте ключ в API Keys с источниками, необходимыми для вашей задачи, или повторно используйте существующий ключ. Поставьте его на свой SDK или отправьте его как X-API-Key из вашего бэкэнда. Bash и PowerShell на этапе 2 работают напрямую с API; установка CLI не требуется.
Используйте хост, настроенный для FlashData OAuth. Владелец учетной записи завершает регистрацию или вход и согласие в браузере; хост сохраняет токены. Это соединение не устанавливает ключ CLI и не требует пробной версии.
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:researchДля агента без ключа, discover имеет право на участие в текущем испытании перед регистрацией. Повторно использовать существующий тест и его профиль. YouTube Download и повторяющиеся задачи требуют доступа владельца.
flashdata discover --profile research --jsonКакие источники могут использовать эту верительные грамоты?
Используйте X-API-Key для обычных запросов HTTP и API-ключ MCP соединений. Токены-носители OAuth работают только на хостинговой конечной точке MCP. YouTube Download нужен ключ API с youtube_download и хранилищем назначения.
| Полномочия | Доступные источники |
|---|---|
| Владелец ключа API | Источники, предоставленные ключу, в том числе youtube_download при утверждении. |
| Временный ключ API | Только разрешённые источники, доступные в пробном режиме. Читайте scopes в текущем ответе проверки личности. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |
Сохранить ключ в CLI
Пропустите импорт, если у CLI уже есть доступ или ваш секретный менеджер поставляет FLASHDATA_API_KEY. В противном случае выберите метод ниже и сохраните тот же профиль исследования для более поздних команд. Сохраненный ключ CLI недоступен автоматически ни для SDK, ни для локальных серверов MCP.
Вставьте ключ в скрытый терминал.
flashdata auth login --profile researchУстановите FLASHDATA_KEY_FILE на путь существующего защищенного файла ключа. Команда читает его через stdin; держите ключ в стороне от чата и командных аргументов.
: "${FLASHDATA_KEY_FILE:?Set the path to your protected API-key file}"
flashdata auth login --profile research --api-key-stdin --non-interactive \
< "$FLASHDATA_KEY_FILE"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(
: "${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'
)Пропустите скрытый ключ, если 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/identity"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}Используйте пользователя OS, профиль и каталог состояния из входа в систему. Замените исследование, если вы используете другой профиль; добавьте --state-dir PATH, если это необходимо. FLASHDATA_API_KEY перекрывает сохраненный ключ. Ожидайте ok: true и data.accessVerified: true; затем проверьте поля идентификации ниже.
flashdata auth status --profile research --json --non-interactiveОтправьте это на новый сеанс вашего агента. Замените google_search на источник, необходимый для выполнения задачи. Ожидайте, что оба инструмента будут успешными; проверьте цены и баланс отдельно перед оплачиваемой работой. Один только перечисленный сервер не проверяет доступ.
Используйте существующее соединение флэш-данных MCP.
Звоните get_pricing с {"source":"google_search","request_count":1}.
Звоните get_balance с {}.
Сообщите, удалось ли сделать оба звонка, есть ли у источника доступная цена.
и доступного кредитного баланса. Нулевой баланс не является ошибкой аутентификации.
Не запускайте поиск или загрузку, не создавайте пробную версию или не меняйте учетные данные.Прочитайте ключ 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 --probe3. Повторное использование доступа для более поздних задач
Держите хранилище учетных данных частным и постоянным при перезапуске процесса. Перепроверьте доступ в новом процессе, прежде чем включить планировщик.
| Полномочия | Для следующей задачи |
|---|---|
| Владелец ключа API | Повторное использование сохраненного ключа. У него нет шага обновления OAuth; замените его, если он истек или отменен. |
| MCP OAuth | Хост обновляет одночасовые токены доступа OAuth с помощью вращающихся токенов обновления. Повторное подключение, когда срок действия гранта 90 истекает или аннулируется. Каждая установка имеет свой магазин токенов; не делитесь файлами обновлений между хостами. |
| Временный ключ API | Завершите требование владельца и передачу полномочий перед повторной работой. Повторно используйте исходный профиль; не регистрируйтесь повторно для каждого запуска. |
Проверьте задачу CLI перед планированием
Требуется Bash и jq. Установите источник для задания. Сценарий использует исследование по умолчанию; установите FLASHDATA_PROFILE и FLASHDATA_STATE_DIR для другого профиля или каталога состояния. Выход 0 с идентификационным номером JSON означает, что ключ владельца готов, установлен и разрешен для этого источника. Пусть ваш планировщик остановится на любом другом выходе. Запрос не подается.
(
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 OAuth | Settings → Connected apps → грант приложения. |
| Заявленный агент API ключ | Settings → Connected apps → Агентские соединения. |
| Ключ API | API 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 перед оплаченной работой; не заменяйте действительный ключ. |