Uwierzytelnianie

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

Jak uzyskać klucz API

1. Zaloguj się do FourA Dashboard
2. Przejdź na stronę API Keys
3. Kliknij Create Key
4. Skopiuj klucz od razu (nie zostanie wyświetlony ponownie w całości)

Twój klucz API wygląda tak: pk_live_a1b2c3d4e5f6...

Używanie klucza API

Dołącz swój klucz API w nagłówku 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 wrzucaj 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 po stronie serwera.
• Zmień klucz w razie wycieku. Wygeneruj nowy klucz w Dashboard i zdezaktywuj stary.

Używanie zmiennych środowiskowych

Zapisz swój 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.

Kolejne kroki

• Quick Start: Wykonaj swój pierwszy request
• API Endpoints: Pełna dokumentacja endpointów
• Error Handling: Prawidłowa obsługa błędów uwierzytelniania