# Керування ключами API

Створіть ключ для вашого додатка або агента. Зберігати його, перевірити доступ і керувати життєвим циклом.

Канонічне посилання: https://flashdata.dev/uk/docs/guides/api-keys-and-permissions
Переглянуто: 2026-11-04 від FlashData

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

## 1. Створення ключа

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

- [Відкрити API Keys](https://flashdata.dev/app/api-keys)
- [Спробуйте підписатися](https://flashdata.dev/uk/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 NAME тут і в пізніх командах. Для заміни ключа потрібен логін --replace.

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

```bash
flashdata auth login
```

- [CLI інсталяція](https://flashdata.dev/uk/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 access. Для названого профілю, Додаток --profile NAME до кожного команди. Ці дані не витрачають на запити.

#### Безкоштовні читання облікового запису

```bash
flashdata auth status
```

- [Налаштування ключа](https://flashdata.dev/uk/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/uk/docs/guides/http-quickstart/reference.md)
- [Перевірити баланс і ціноутворення](https://flashdata.dev/uk/docs/guides/credits-and-billing/reference.md)

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

### Як працює робота з дозволами на джерело

ключ може використовуватися тільки надані джерела. Вибір продукту відокремлений від ціноутворення: кожен ключ на рахунок витрачається з загального балансу, включаючи придбані кредити. Не обмежується ключ не має власних витрат. Надання послуг з надання дозволу на майбутнє.

- [Каталог послуг Агента](https://flashdata.dev/uk/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/uk/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>

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

Стоп запланованих дзвоників, відкликаючи ключ або підключення нижче, після чого повторіть перевірку безкоштовного з старим обліковим записом. Слід відхилити. Відправлення локально не відкликає доступ до сервера.

| Тип доступу | Де відкликати |
| --- | --- |
| Ordinary API ключ | API Keys |
| ключ Claimed агента | Settings → Connected apps → Agent connections |
| MCP OAuth грант | Settings → Connected apps |

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