Uwierzytelnianie

Wappfy API obsluguje dwie metody uwierzytelniania. Kazde zapytanie musi zawierac jedna z nich.

Klucz API (zalecane)

Przekaz klucz API w naglowku X-Api-Key:

curl https://api.wappfy.io/api/instances \
  -H "X-Api-Key: wappfy_sk_abc123def456..."

Tworzenie klucza API

Klucze API mozna tworzyc za pomoca panelu lub API. Klucze sa przypisane do uzytkownika i maja takie same uprawnienia jak konto uzytkownika.

curl -X POST https://api.wappfy.io/api/api-keys \
  -H "Authorization: Bearer YOUR_SUPABASE_JWT" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Production Key" }'

Wartosc klucza jest zwracana tylko raz podczas tworzenia. Przechowuj ja bezpiecznie.

Token Bearer (Supabase JWT)

Przekaz token dostepu Supabase w naglowku Authorization:

curl https://api.wappfy.io/api/instances \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Tokeny JWT sa krotkotrwale i wymagaja odswiezania. Sa zwykle uzywane przez panel frontendowy, a nie do integracji serwer-serwer.

Dobre praktyki bezpieczenstwa

Uzywaj kluczy API do komunikacji serwer-serwer

Klucze API nie wygasaja i sa latwiejsze w zarzadzaniu w przypadku integracji backendowych.

Regularnie rotuj klucze

Jesli klucz zostal skompromitowany, usun go i utworz nowy.

Zawsze uzywaj HTTPS

Wszystkie zapytania API musza uzywac HTTPS. Zapytania HTTP beda odrzucane.

Nie eksponuj kluczy w kodzie frontendowym

Klucze API powinny byc uzywane wylacznie w kodzie po stronie serwera, nigdy w JavaScript po stronie klienta.

Odpowiedzi bledow

Status	Opis
`401`	Brakujacy lub nieprawidlowy token uwierzytelniania
`403`	Niewystarczajace uprawnienia do tego zasobu

Pierwsze Kroki

Przewodniki

Uwierzytelnianie

Uwierzytelnianie

Klucz API (zalecane)

Tworzenie klucza API

Token Bearer (Supabase JWT)

Dobre praktyki bezpieczenstwa

Odpowiedzi bledow

​Uwierzytelnianie

​Klucz API (zalecane)

​Tworzenie klucza API

​Token Bearer (Supabase JWT)

​Dobre praktyki bezpieczenstwa

​Odpowiedzi bledow

Uwierzytelnianie

Klucz API (zalecane)

Tworzenie klucza API

Token Bearer (Supabase JWT)

Dobre praktyki bezpieczenstwa

Odpowiedzi bledow