DocsAPI Keys

Zarządzanie API Key

Dowiedz się, jak tworzyć, zarządzać i zabezpieczać klucze FreeFileTools API.

Tworzenie API Key

Aby utworzyć API Key:

  1. Zaloguj się na swoje konto na freefiletools.io
  2. Przejdź do Panel > API Keys
  3. Kliknij Utwórz API Key
  4. Nadaj kluczowi opisową nazwę (np. "Moja aplikacja", "Pipeline CI")
  5. Skopiuj i bezpiecznie przechowaj klucz -- zostanie wyświetlony tylko raz

Twój klucz będzie wyglądał następująco: fft_abc123def456...

Plan darmowy

FunkcjaLimit
Klucze API na konto1
Żądania na godzinę50
Maksymalny rozmiar pliku25 MB
Wszystkie endpointyW zestawie

Regenerowanie klucza

Jeśli Twój API Key został naruszony lub potrzebujesz nowego:

  1. Przejdź do Panel > API Keys
  2. Kliknij przycisk Regeneruj obok istniejącego klucza
  3. Potwierdź operację -- stary klucz zostanie natychmiast unieważniony
  4. Skopiuj i przechowaj nowy klucz

Ostrzeżenie: Regenerowanie klucza natychmiast unieważnia stary klucz. Aplikacje korzystające ze starego klucza przestaną działać do momentu aktualizacji nowym kluczem.

Najlepsze praktyki bezpieczeństwa

1.

Nigdy nie udostępniaj API Key

Nie udostępniaj klucza w publicznych repozytoriach, na forach ani w kodzie po stronie klienta.

2.

Używaj zmiennych środowiskowych

Przechowuj API Key w zmiennych środowiskowych, nie w kodzie źródłowym.

3.

Trzymaj go po stronie serwera

Wykonuj wywołania API z serwera backendowego. Nigdy nie ujawniaj klucza w frontendowym JavaScript.

4.

Regeneruj w przypadku naruszenia

Jeśli klucz mógł zostać ujawniony, natychmiast go zregeneruj z panelu.

Przykład: Używanie zmiennych środowiskowych

bash
# .env file (do NOT commit this)
FFT_API_KEY=fft_your_api_key_here
javascript
// Read from environment variable
const apiKey = process.env.FFT_API_KEY;

const response = await fetch("https://freefiletools.io/api/image-compress", {
  method: "POST",
  headers: {
    "x-api-key": apiKey,
  },
  body: formData,
});