Uwierzytelnianie

Do integracji zewnętrznych Leezy używa OAuth 2.0 w wariancie Authorization Code. PKCE z S256 jest wymagane.

Endpointy

Endpoint	Metoda	Zastosowanie
/api/oauth/authorize	GET	Rozpoczęcie autoryzacji i ekran zgody.
/api/oauth/token	POST	Wymiana kodu autoryzacyjnego albo tokenu odświeżającego.
/api/oauth/revoke	POST	Unieważnienie tokenu dostępu lub odświeżającego.

Żądanie autoryzacji

https://leezy.ai/api/oauth/authorize?
  response_type=code&
  client_id=YOUR_CLIENT_ID&
  redirect_uri=https://example.com/oauth/callback&
  scope=leads:read%20webhooks:manage&
  state=random_state&
  code_challenge=BASE64URL_SHA256_CODE_VERIFIER&
  code_challenge_method=S256

Wymiana tokenu

curl -X POST "https://leezy.ai/api/oauth/token" \
  -H "Content-Type: application/json" \
  -u "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" \
  -d '{
    "grant_type": "authorization_code",
    "code": "AUTHORIZATION_CODE",
    "redirect_uri": "https://example.com/oauth/callback",
    "code_verifier": "ORIGINAL_CODE_VERIFIER"
  }'

Odpowiedź zawiera token dostępu typu Bearer, token odświeżający, czas ważności, przyznane zakresy oraz api_base_url.

Zakresy uprawnień

Zakres	Uprawnia do
leads:read	odczytu leadów.
leads:write	tworzenia i aktualizacji leadów.
conversations:read	odczytu rozmów.
conversations:write	wysyłania wiadomości w rozmowach.
tickets:read	odczytu zgłoszeń serwisowych.
tickets:write	tworzenia i aktualizacji zgłoszeń.
meetings:read	odczytu zarezerwowanych spotkań.
webhooks:manage	tworzenia webhooków i zarządzania nimi.

Zapytania do API

curl "https://leezy.ai/api/v1/leads" \
  -H "Authorization: Bearer lzy_at_your_access_token"