# Zarządzanie kluczami API

Utwórz klucz dla aplikacji lub agenta. Przechowuj go, sprawdź dostęp i zarządzaj jego cyklem życia.

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/guides/api-keys-and-permissions
Przegląd: 2026-11-04 przez FlashData

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

## 1. Utwórz klucz

1. Zarejestruj się na zweryfikowanym koncie i otwórz API Keys. Ponownie użyj autoryzowanego klucza, jeśli już go masz.
2. Nazwa aplikacji i środowiska, wybierz termin ważności i wybierz źródła, których potrzebuje. Wybierz Google Search dla pierwszego przykładu wyszukiwania.
3. Utwórz klucz i zapisz go poniżej. Daj niezależnym agentom i aplikacji produkcyjnych oddzielne klucze, dzięki czemu można je anulować indywidualnie.

- [Otwórz API Keys](https://flashdata.dev/app/api-keys)
- [Spróbuj przed zapisaniem](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md)

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

## 2. Przechowywać klucz

Wybierz sposób, w jaki uruchomisz FlashData. Przykłady API i SDK odczytują FLASHDATA_API_KEY; CLI może zapisać klucz w swoim chronionym profilu. W produkcji, wpisz referencje ze swojego tajnego sklepu.

### Bash · API / SDK

#### Ustaw klucz do tego terminala

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

#### Ustaw klucz do tego terminala

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

Wklej klucz na ukrytym poście. Dla profilu o nazwie, tutaj i w późniejszych poleceniach należy dołączyć nazwę --profile. Wcześniej skonfigurowany profil wymaga logowania --replace, aby zastąpić swój klucz.

#### Zapisz klucz

```bash
flashdata auth login
```

- [Instalacja CLI](https://flashdata.dev/pl/docs/guides/flashdata-cli/reference.md#install)


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

## 3. Weryfikacja dostępu

Uruchom darmowe sprawdzenie w tym samym terminalu lub profilu CLI. Użyj zakładki, która pasuje do sposobu przechowywania klucza.

### Bash / cURL

Ponowne użycie FLASHDATA_API_KEY z wcześniejszego sprawdzenia w tym samym terminalu.

#### Czytaj konto 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

Ponowne użycie FLASHDATA_API_KEY z wcześniejszego sprawdzenia w tym samym terminalu.

#### Czytaj konto 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

Użyj zapisanego dostępu do CLI. Dla o nazwie profilu, przyłącz nazwę --profile do każdego polecenia. Te odczyty nie wydają kredytów zapytania.

#### Bezpłatne czytanie konta

```bash
flashdata auth status
```

- [Ustaw klucz](https://flashdata.dev/pl/docs/guides/api-keys-and-permissions/reference.md#store)


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

### Potwierdź konto i źródło

HTTP zwraca te pola bezpośrednio. Z CLI JSON, znaleźć je pod data.identity.identity, a także wymagają data.accessVerified: true.

| Sprawdź | Oczekiwane |
| --- | --- |
| accountId | Konto, które jest właścicielem tego obciążenia pracą. |
| access | ready |
| scopes | Zawiera google_search dla pierwszego wyszukiwania. |
| recurringAllowed | true przed planowaną pracą właściciela. |

- [Uruchom swoje pierwsze zapytanie](https://flashdata.dev/pl/docs/guides/http-quickstart/reference.md)
- [Kontrola równowagi i cen](https://flashdata.dev/pl/docs/guides/credits-and-billing/reference.md)

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

### Jak działają uprawnienia źródłowe

Klucz może korzystać tylko ze swoich źródeł. Wybór produktu jest odrębny od cen: każdy klucz na koncie wydaje ze wspólnego salda, w tym zakupionych kredytów. Ograniczony klucz nie ma własnego limitu wydatków. Przyszłe produkty wymagają wyraźnego zezwolenia.

- [Katalog uprawnień agenta](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md#permissions)

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

## Jeśli klucz jest narażony

1. Otworzyć wyświetlony klucz natychmiast na stronie konsoli dopasowania poniżej, i zatrzymać jego zaplanowane dzwoniących.
2. Utwórz zastępstwo z wymaganymi uprawnieniami, zainstaluj je w tajnym sklepie każdego rozmówcy i uruchom bezpłatną weryfikację powyżej.
3. Przegląd History i wykorzystanie konta dla nieoczekiwanej aktywności. Usunięcie sekretu z akt nie unieważnia go.

- [API Keys](https://flashdata.dev/app/api-keys)
- [Korzystanie z konta](https://flashdata.dev/pl/docs/guides/usage-and-limits/reference.md#usage)

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

## Obróć klucz

1. Utwórz zastępstwo z wymaganymi źródłami i zainstalować je w środowisku docelowym.
2. Powtórzyć darmową weryfikację powyżej, a następnie przełączyć aplikację lub terminarz. Uaktualnij każdego zamierzonego rozmówcę.
3. Odśwież stary klucz po podłączeniu słuchaczy. Tajemnica uaktualniona na laptopie nie aktualizuje usług wdrożonych.

### Zamień klawisz CLI · wklej w ukryty sygnał

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


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

## Dostęp ponownie

Zaprzestanie połączeń planowych, cofnięcie pasującego klucza lub połączenia poniżej, a następnie powtórzenie bezpłatnej weryfikacji ze starym creditial. Należy je odrzucić. Wylogowanie się lokalnie nie unieważnia dostępu do serwera.

| Typ dostępu | Gdzie należy odwołać |
| --- | --- |
| Zwykły klucz API | API Keys |
| Zatwierdzony klucz agenta | Settings → Connected apps → Agent connections |
| MCP OAuth grant | Settings → Connected apps |

- [API Keys](https://flashdata.dev/app/api-keys)
- [Connected apps](https://flashdata.dev/app/settings/connections)
- [Uwierzytelnianie rozwiązywania problemów](https://flashdata.dev/pl/docs/guides/headers-and-authentication/reference.md#errors)
