Перейти до вмісту
UK
Отримати ключ 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 ключТільки надані джерела даних, що надаються. Читання сфер із відповіді на поточну ідентичність.
MCP OAuthgoogle_search, youtube_search, youtube_metadata, youtube_transcript

Заощаджуйте ключ в CLI

Зареєструвати імпорт, якщо CLI вже має доступ або секретний менеджер постачає FLASHDATA_API_KEY. В іншому випадку виберіть метод нижче і зберігайте той самий профіль дослідження для пізніх команд. Увімкнути CLI ключ не автоматично доступний для SDKs або локальних серверів 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-key

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. Встановити SOURCE до джерела задачі. Скрипт використовує дослідження за замовчуванням; встановити FLASHDATA_PROFILE і FLASHDATA_STATE_DIR для різних профілів або державного каталогу. Випадковий 0 з ідентичністю JSON – ключ власника, встановленого та допущеним для цього джерела. Зареєструйтеся на будь-який інший виїзд. Немає запиту.

Перевірка доступу до Fresh-process · 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}'
)

Якщо доступ досі пробний

Пройдіть інструкцію з пробного доступу та прив’язування з початковим профілем. Після схвалення власником і передачі облікових даних безкоштовна перевірка має показати owned та recurringAllowed: true. Подальші запити використовують спільний баланс власника; невикористані пробні кредити не переносяться. Вхід MCP OAuth створює окреме підключення й не прив’язує цей пробний доступ.

Відновити доступ

Запобігання повторної роботи першим. Відновити відповідні дані нижче, потім повторити безкоштовну перевірку з свіжого процесу або сеансу перед очищенням місцевого доступу. Визначте відмову від автентифікації або запит про відключення; не затверджуйте нове з'єднання під час перевірки. Місцевий логотип не відкликає доступ до сервера.

З'єднанняДе відкликати
MCP OAuthSettings → Connected apps → грант програми.
Claimed агент 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 перед платною роботою; не замінити дійсний ключ.