# Заголовки и аутентификация

Используйте правильный хост и учётные данные, затем проверьте доступ одним бесплатным запросом.

Каноническая ссылка: https://flashdata.dev/ru/docs/guides/headers-and-authentication
Разработчик: 2026-11-04 by 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/ru/docs/guides/api-keys-and-permissions/reference.md)
- [Подключение через MCP](https://flashdata.dev/ru/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/ru/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 или префикс Bearer. |
| 403/Источник отсутствует | Попросите владельца предоставить необходимый источник для этого ключа. |
| 503 в этом бесплатном чтении | Повторите прочитанное позже. Статус учетной записи не был проверен; не делайте вывод о том, что платный запрос готов. |

