# Керівники та автентифікації

Використайте правильний хост і облікові дані, а потім перевірте доступ одним безплатним запитом.

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

<a id="requests"></a>

## База URLs

| Мета | База URL | Автентифікація |
| --- | --- | --- |
| Запити та завдання даних | https://data.flashdata.dev/v1 | X-API-Key |
| Ідентифікація, баланс, ціноутворення, ліміти та використання | https://api.flashdata.dev/v2 | X-API-Key |
| Віддалений MCP | https://data.flashdata.dev/mcp | Хост-менеджмент OAuth, або X-API-Key |


<a id="choose"></a>

## Ауттентичні заголовки

REST вимагає використання X-API-Key з ключем або ключем власника. Відправити JSON тіла з Content-Type: application/json. CLI профілів, SDK-середовища та MCP з'єднання зберігають облікові дані окремо.

### REST / API ключ

#### Заголовки запитів

```http
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json
```


### MCP / OAuth

Додайте MCP, отримайте, зберігайте та освіжайте цей токени через логін. Використовуйте його тільки в кінцевій точці MCP. Запуски за допомогою ключа API замість відправки X-API-Key.

#### Головний керуючий MCP

```http
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN
```


- [Отримайте API-ключ](https://flashdata.dev/uk/docs/guides/api-keys-and-permissions/reference.md)
- [Зв'язатися з MCP](https://flashdata.dev/uk/docs/integrations/mcp-clients/reference.md)

<a id="check"></a>

## Перевірити свій ключ

Виконайте це в терміналі. Доступ до кінцевої точки особи без витратних кредитів. Пропустити ключову підказку, якщо FLASHDATA_API_KEY вже встановлений.

### Bash / cURL

Вимагає Bash і cURL 7.76+. Випробуйте приховану клавішу підказки, якщо ваше оточення вже постачає FLASHDATA_API_KEY. Виконайте дані команди в одному терміналі.

#### Встановити ключ · пропустити, якщо вже налаштовано

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

#### Читання облікового запису 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 вже встановлена. Виконайте дані команди в одному терміналі.

#### Встановити ключ · пропустити, якщо вже налаштовано

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

#### Читання облікового запису 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
}
```



<a id="result"></a>

### Відповідна відповідь

Витратити HTTP 200. Перевірити призначений обліковий запис, access: ready та джерело в обсягах. Тимчасовий ключ має accountType: temporary; рекурентна робота власника вимагає recurringAllowed: true.

#### Особиста ідентичність · ілюстративна відповідь

```json
{
  "accountId": "acc_example",
  "apiKeyId": "key_example",
  "accountType": "owned",
  "access": "ready",
  "scopes": [
    "google_search"
  ],
  "recurringAllowed": true
}
```

- [Виконайте перший виклик API](https://flashdata.dev/uk/docs/guides/http-quickstart/reference.md#curl)

<a id="storage"></a>

## Пристрої для зберігання URLs

Результат і завантаження URLs включають в себе власну авторизації. Додайте повернутий URL без X-API-Key, OAuth токенів або браузера cookie.


<a id="errors"></a>

## Виправлення неполадок

| Відповідь | Наступний крок |
| --- | --- |
| 401 | Перевірити ключ в цьому середовищі, його витривалість і відродження. Використовуйте поточний ключ API, не токен MCP або префікс ведмедя. |
| 403 / джерело відсутні | Запитати власника для надання необхідного джерела до цього ключа. |
| 503 на цьому безкоштовному читанні | Збережіть читати далі. Статус облікового запису не був перевірений; не вважає, що платний запит готовий. |

