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

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

Управление API-ключами

Создайте ключ для вашего приложения или агента. Храните его, проверяйте доступ и управляйте его жизненным циклом.

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

1. Создать ключ

  1. Войдите в свою проверенную учетную запись и откройте API Keys. Повторное использование авторизованного ключа, если он у вас уже есть.
  2. Назовите его для приложения и среды, выберите срок действия и выберите источники, которые ему нужны. Выберите Google Search для первого примера поиска.
  3. Создайте ключ и сохраните его ниже. Дайте независимым агентам и производственным приложениям отдельные ключи, чтобы вы могли отозвать их индивидуально.

2. Хранить ключ

Выберите способ запуска FlashData. Примеры API и SDK читают FLASHDATA_API_KEY; CLI может сохранить ключ в своем защищенном профиле. В производстве впрыскивайте учетные данные из вашего секретного магазина.

Установите ключ для этого терминала
# 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

3. Проверить доступ

Запустите бесплатную проверку в том же терминале или в профиле CLI. Используйте вкладку, которая соответствует тому, как вы хранили ключ.

Повторно используйте 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 возвращает эти поля напрямую. С CLI JSON найдите их под data.identity.identity, а также потребуйте data.accessVerified: true.

ПроверитьОжидаемый
accountIdУчетная запись, которой принадлежит эта рабочая нагрузка.
accessready
scopesВключает google_search для первого поиска.
recurringAllowedtrue перед началом работы.

Как работают разрешения источника

Ключ может использовать только предоставленные ему источники. Выбор продукта отделен от ценообразования: каждый ключ на счете расходуется из общего баланса, включая приобретенные кредиты. Ограниченный ключ не имеет собственного лимита расходов. Будущие продукты требуют явного разрешения.

Если ключ раскрыт

  1. Отзыв открытого ключа немедленно на соответствующей странице консоли ниже и остановка его запланированных абонентов.
  2. Создайте замену с необходимыми разрешениями, установите ее в секретном магазине каждого абонента и запустите бесплатную проверку выше.
  3. Просмотрите History и использование учетной записи для неожиданной активности. Удаление секрета из файла не отменяет его.

Вращайте ключ

  1. Создайте замену с требуемыми источниками и установите ее в целевую среду.
  2. Повторите бесплатную проверку выше, затем переключите приложение или планировщик. Обновление каждого предполагаемого звонка.
  3. Отмените старый ключ после того, как звонящие переключились. Секрет, обновленный на вашем ноутбуке, не обновляет развернутые службы.
Заменить ключ CLI · вставить в скрытую подсказку
flashdata auth login --replace
flashdata auth status

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

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

Тип доступаГде отозвать
Обычный ключ APIAPI Keys
Заявленный ключ агентаSettings → Connected apps → Agent connections
MCP OAuthQSettings → Connected apps