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

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

Каноническая ссылка: https://flashdata.dev/ru/docs/guides/api-keys-and-permissions
Разработчик: 2026-11-04 by FlashData

<a id="create"></a>

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

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

- [Открыть API Keys](https://flashdata.dev/app/api-keys)
- [Попробуйте перед регистрацией](https://flashdata.dev/ru/docs/guides/agent-onboarding/reference.md)

<a id="store"></a>

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

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

### Bash · API / SDK

#### Установите ключ для этого терминала

```bash
# 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
```


### PowerShell 7 · API / SDK

#### Установите ключ для этого терминала

```powershell
# 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
```


### CLI

Вставьте ключ в скрытый запрос. Для именованного профиля добавьте имя --profile здесь и в более поздних командах. Ранее настроенный профиль требует входа в --replace для замены ключа.

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

```bash
flashdata auth login
```

- [Установка CLI](https://flashdata.dev/ru/docs/guides/flashdata-cli/reference.md#install)


<a id="verify"></a>

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

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

### Bash / cURL

Повторно используйте FLASHDATA_API_KEY из предыдущей проверки в том же терминале.

#### Прочитать аккаунт JSON

```bash
(
: "${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'
)
```


### PowerShell 7

Повторно используйте FLASHDATA_API_KEY из предыдущей проверки в том же терминале.

#### Прочитать аккаунт JSON

```powershell
& {
  $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
}
```


### CLI

Используйте сохраненный доступ CLI. Для именованного профиля добавьте имя --profile к каждой команде. Эти чтения не тратят кредиты на запросы.

#### Бесплатный аккаунт читать

```bash
flashdata auth status
```

- [Настройка ключа](https://flashdata.dev/ru/docs/guides/api-keys-and-permissions/reference.md#store)


<a id="verified"></a>

### Подтвердите аккаунт и источник

HTTP возвращает эти поля напрямую. С CLI JSON найдите их под data.identity.identity, а также потребуйте data.accessVerified: true.

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

- [Запустите свой первый запрос](https://flashdata.dev/ru/docs/guides/http-quickstart/reference.md)
- [Проверьте баланс и цены](https://flashdata.dev/ru/docs/guides/credits-and-billing/reference.md)

<a id="permissions"></a>

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

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

- [Агентское разрешение каталог](https://flashdata.dev/ru/docs/guides/agent-onboarding/reference.md#permissions)

<a id="leak"></a>

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

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

- [API Keys](https://flashdata.dev/app/api-keys)
- [Использование аккаунта](https://flashdata.dev/ru/docs/guides/usage-and-limits/reference.md#usage)

<a id="rotate"></a>

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

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

### Заменить ключ CLI · вставить в скрытую подсказку

```bash
flashdata auth login --replace
flashdata auth status
```


<a id="revoke"></a>

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

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

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

- [API Keys](https://flashdata.dev/app/api-keys)
- [Connected apps](https://flashdata.dev/app/settings/connections)
- [Устранение неполадок в аутентификации](https://flashdata.dev/ru/docs/guides/headers-and-authentication/reference.md#errors)
