# Uwierzytelnianie

> URL: https://foura.ai/pl/docs/getting-started/authentication
> Updated: 2026-10-29
> Index: https://foura.ai/llms.txt

Każde request do FourA API wymaga uwierzytelnienia. Ta strona wyjaśnia, jak uzyskać, używać i zarządzać kluczem API.

## Uzyskiwanie klucza API

1. Zaloguj się do [FourA Dashboard](https://foura.ai/dashboard)
2. Przejdź do strony **API Keys**
3. Kliknij **Create Key**
4. Skopiuj klucz z okna potwierdzenia

Twój klucz API wygląda następująco: `pk_live_a1b2c3d4e5f6...`

Klucze utworzone obecnie można podejrzeć: kliknij ikonę oka w wierszu klucza, aby w razie potrzeby ponownie wyświetlić pełny token (zobacz [Zarządzanie kluczami API](https://foura.ai/docs/dashboard/api-keys), aby poznać proces wyświetlania i uprawnienia). Starsze klucze, utworzone przed wprowadzeniem tej funkcji, nie mogą być ponownie wyświetlone i mają ikonę kłódki; wygeneruj je ponownie, aby przejść na nowy system.

## Używanie klucza API

Dołącz swój klucz API w headerze `X-API-Key` każdego requestu:

```bash
curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com"}'
```

W Pythonie:

```python
import requests

response = requests.post(
    "https://eu.api.foura.ai/api/single/",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={"method": "GET", "url": "https://example.com"}
)
```

W Node.js:

```javascript
const response = await fetch('https://eu.api.foura.ai/api/single/', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ method: 'GET', url: 'https://example.com' })
});
```

## Bezpieczeństwo klucza API

Traktuj swój klucz API jak hasło:

- **Nie commituj go do systemu kontroli wersji.** Zamiast tego użyj zmiennych środowiskowych.
- **Nie ujawniaj go w kodzie po stronie klienta.** Używaj go wyłącznie w aplikacjach serwerowych.
- **Wykonaj rotację w przypadku naruszenia bezpieczeństwa.** Wygeneruj klucz ponownie w Dashboardzie. Stary sekret przestaje działać w ciągu minuty, a każde jego wyświetlenie jest rejestrowane w dzienniku audytu, co ułatwia wykrycie przejętych danych uwierzytelniających po fakcie.

### Używanie zmiennych środowiskowych

Przechowuj klucz w zmiennej środowiskowej:

```bash
export FOURA_API_KEY="pk_live_a1b2c3d4e5f6..."
```

Następnie odwołaj się do niego w kodzie:

```python
import os
api_key = os.environ["FOURA_API_KEY"]
```

```javascript
const apiKey = process.env.FOURA_API_KEY;
```

## Typowe błędy uwierzytelniania

Wszystkie błędy uwierzytelniania zwracają status `401 Unauthorized`.

| Error | Message | Cause | Fix |
|-------|---------|-------|-----|
| 401 | Missing API key. Include X-API-Key header. | Brak nagłówka `X-API-Key` w żądaniu | Dodaj nagłówek `X-API-Key` |
| 401 | Invalid API key | Nieprawidłowy klucz, zbędne białe znaki lub dezaktywowany klucz | Zweryfikuj klucz, usuń białe znaki lub wygeneruj nowy klucz w Dashboardzie |

Jeśli FourA chwilowo nie może zweryfikować klucza, na przykład podczas przełączania bazy danych, zwraca `503` z `API key check temporarily unavailable` i `Retry-After: 5`, nigdy `401`. Ponów próbę po wskazanym czasie oczekiwania: Twój klucz jest prawidłowy.

Każda odpowiedź, zarówno zakończona sukcesem, jak i błędem, zawiera nagłówek `X-Foura-Request-Id`, z wyjątkiem treści, których FourA w ogóle nie jest w stanie odczytać (nieprawidłowy format JSON lub treść powyżej 100 KB), które są odrzucane przed przypisaniem identyfikatora. Zapisuj go w logach po swojej stronie, aby wsparcie techniczne mogło później odszukać konkretne wywołanie.

## Następne kroki

- [Szybki start](https://foura.ai/docs/getting-started/quick-start): Wykonaj pierwsze żądanie
- [Zarządzanie kluczami API](https://foura.ai/docs/dashboard/api-keys): Wyświetlaj, edytuj, odnawiaj i usuwaj klucze
- [Endpointy API](https://foura.ai/docs/api/endpoints): Pełna dokumentacja endpointów
- [Obsługa błędów](https://foura.ai/docs/api/errors): Prawidłowa obsługa błędów uwierzytelniania
