Uwierzytelnianie

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
  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, 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:

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:

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:

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:

export FOURA_API_KEY="pk_live_a1b2c3d4e5f6..."

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

import os
api_key = os.environ["FOURA_API_KEY"]
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

Aktualizacja: 29 października 2026