API i integracje¶

Aster nie udostępnia własnego publicznego REST API. Komunikacja z przeglądarką odbywa się klasycznie — Django renderuje HTML, akcje modyfikujące stan to formularze POST. Sekcja opisuje:

Adresy URL wystawiane na zewnątrz (do przeglądarki).
Integracje z usługami trzecimi (TMDB, Brevo/SMTP).

Endpointy aplikacji¶

Pełna mapa: UX → Mapa serwisu. Tutaj — krótki przegląd kontraktu wybranych endpointów modyfikujących stan.

`POST /movies/<tmdb_id>/status/`¶

Aktualizuje status oglądania (watchlist / watched).

Pole formularza	Typ	Wartości	Opis
`csrfmiddlewaretoken`	string	—	wymagane
`action`	string	`watchlist` / `watched`	docelowy status

Odpowiedź: 302 redirect na /movies/<tmdb_id>/. Komunikat w sesji.

`POST /movies/<tmdb_id>/rating/`¶

Wystawia, modyfikuje lub usuwa ocenę.

Pole	Wartości	Opis
`action`	`save` / `delete`	tryb
`score`	string „0.5" – „5.0" co 0.5	wymagane gdy `action=save`

`POST /movies/<tmdb_id>/comments/`¶

Tworzy komentarz.

Pole	Opis
`content`	text, max 2000 znaków

`POST /movies/<tmdb_id>/comments/<comment_id>/delete/`¶

Usuwa komentarz. Tylko autor (sprawdzane w services.delete_own_comment).

Integracja z TMDB¶

Klient w movies/tmdb.py opakowuje httpx.Client i wystawia metody domeny: discover, search_movies, movie_details, movie_credits, genre_list, trending_week.

Base URL: https://api.themoviedb.org/3 (zmienna TMDB_API_BASE_URL)
Authoryzacja: klucz v3 jako parametr api_key= (zmienna TMDB_API_KEY)
Język: language=pl-PL (zmienna TMDB_LANGUAGE)
Timeout: 10 s domyślnie (zmienna TMDB_REQUEST_TIMEOUT)
Obsługa błędów: TmdbApiError (4xx/5xx, network), TmdbConfigError (brak klucza). Service layer łapie i zwraca puste wyniki + log warning.

Przykład: pobranie szczegółów filmu¶

from movies.tmdb import default_client

client = default_client()
data = client.movie_details(tmdb_id=27205, append=("credits",))
# data["title"], data["overview"], data["credits"]["cast"], data["credits"]["crew"]

W aplikacji zamiast bezpośredniego użycia klienta zwykle wywołujemy funkcje serwisowe (movies/services.py): fetch_and_cache_movie(tmdb_id), discover_tmdb_movies(...), search_tmdb_movies(query). Funkcje te realizują strategię „cache-first": najpierw lokalna baza, w razie miss — TMDB + zapis do bazy.

Atrybucja TMDB¶

Aplikacja używa danych TMDB i musi wyświetlać atrybucję zgodnie z ich regulaminem. Atrybucja znajduje się w stopce serwisu i w README.

Integracja e-mail¶

Dwa backendy do wyboru, wybierane na podstawie obecności BREVO_API_KEY:

Tryb	Backend	Konfiguracja
Brevo (preferowane w prod)	`anymail.backends.brevo.EmailBackend`	`BREVO_API_KEY`
SMTP (Gmail, MailHog itp.)	`django.core.mail.backends.smtp.EmailBackend`	`EMAIL_HOST`, `EMAIL_PORT`, `EMAIL_HOST_USER`, `EMAIL_HOST_PASSWORD`, `EMAIL_USE_TLS`

Wysyłane wiadomości:

Aktywacja konta — accounts/utils.py:send_activation_email korzysta z szablonów accounts/emails/activation_email.{txt,html}.
Reset hasła — wbudowany auth_views.PasswordResetView z polskimi szablonami accounts/emails/password_reset_email.{txt,html}.

DEFAULT_FROM_EMAIL używany jako adres nadawcy.