# Dokumentacja amodb

> Zacznij od szybkiego startu, by wykonać pierwsze wywołanie w dwie minuty. Potem przeczytaj, jak działają klucze, limity żądań, błędy, języki i obrazy. amodb zachowuje ścieżki i JSON z TMDB v3 i OMDb, więc większość stron wyjaśnia, co jest takie samo, co dodaje amodb i w których nielicznych miejscach się różni.

## Bazowe adresy URL

| Zastosowanie   | Bazowy URL                                | Parametr klucza                       |
| -------------- | ----------------------------------------- | ------------------------------------- |
| Styl TMDB v3   | `https://api.amodb.dev/3`                 | `api_key` lub `Authorization: Bearer` |
| Styl OMDb      | `https://api.amodb.dev/omdb/`             | `apikey`                              |
| Obrazy         | `https://img.amodb.dev/t/p/{size}/{file}` | brak                                  |
| Katalog planów | `https://api.amodb.dev/plans`             | brak                                  |

### Pierwsze kroki

- [Szybki start](https://amodb.dev/pl/quickstart/): Pierwsze wywołanie amodb: zdobądź klucz, pobierz szczegóły filmu w curl, JavaScript, Python, PHP lub Go, potem załaduj plakat z img.amodb.dev. Poniżej 2 minut.
- [Uwierzytelnianie](https://amodb.dev/pl/authentication/): Jak wysłać klucz amodb: api_key w zapytaniu, nagłówek Authorization Bearer albo apikey dla wywołań OMDb. Format klucza, przechowywanie, rotacja i błędy 401.

### Koncepty

- [Limity żądań](https://amodb.dev/pl/rate-limits/): amodb limituje klucz liczbą żądań na minutę w przesuwanym oknie 60 sekund: 20, 40 lub 120 zależnie od planu. Czytaj nagłówki limitu i obsłuż 429 z Retry-After.
- [Błędy](https://amodb.dev/pl/errors/): Każdy błąd amodb ze statusem HTTP, status_code i komunikatem TMDB oraz kształt błędu OMDb. Co oznacza każdy z nich i co powinien zrobić twój klient dalej.
- [Języki](https://amodb.dev/pl/languages/): amodb serwuje tytuły, opisy i nazwy w 14 językach. Podaj tag w stylu TMDB, np. ru-RU lub pt-BR, w language; każdy inny tag wraca do angielskiego.
- [Obrazy](https://amodb.dev/pl/images/): Ładuj plakaty, tła i zdjęcia osób z img.amodb.dev na ścieżkach i w rozmiarach TMDB, od w92 do original. Bez klucza, cache 30 dni, jeden wzorzec URL.

### Dokumentacja API

- [API szczegółów filmu](https://amodb.dev/pl/movies/): API szczegółów filmu z tymi samymi ścieżkami i JSON co TMDB v3. Pobierz film po ID, dołącz obsadę, oceny i nastroje przez append_to_response, 14 języków.
- [API szczegółów serialu](https://amodb.dev/pl/tv-series/): API szczegółów serialu z tymi samymi ścieżkami i JSON co TMDB v3. Serial po ID z sezonami, sieciami, klasyfikacją wiekową i dostawcami streamingu.
- [API sezonów i odcinków seriali](https://amodb.dev/pl/tv-seasons-episodes/): API sezonów i odcinków seriali z tymi samymi ścieżkami i JSON co TMDB v3. Odczytaj sezon ze wszystkimi odcinkami albo jeden odcinek z datą emisji i kadrem.
- [API szczegółów osoby](https://amodb.dev/pl/people/): API szczegółów osoby z tymi samymi ścieżkami i JSON co TMDB v3. Aktor lub ekipa po ID z biografią, filmografią, zewnętrznymi ID i listą popularnych osób.
- [API obsady i ekipy](https://amodb.dev/pl/credits/): API obsady i ekipy z tymi samymi ścieżkami i JSON co TMDB v3. Pobierz obsadę i ekipę filmów, seriali, sezonów i odcinków z polami order, department i job.
- [API wyszukiwania](https://amodb.dev/pl/search/): API wyszukiwania z tymi samymi ścieżkami i JSON co TMDB v3. Znajdź filmy, seriale, osoby, kolekcje, firmy i słowa kluczowe po tekście, z filtrem roku.
- [Discover API](https://amodb.dev/pl/discover/): Discover API z tymi samymi filtrami co TMDB v3. Wypisuj filmy i seriale według gatunku, obsady, firmy, słowa kluczowego, roku, oceny, czasu trwania i dostawcy.
- [Trendy i listy](https://amodb.dev/pl/trending-lists/): API trendów filmowych ze ścieżkami TMDB v3: wykresy dzienne i tygodniowe oraz listy now playing, popular, top rated i upcoming, w cache 30 minut.
- [Gatunki i słowniki](https://amodb.dev/pl/genres/): Lista gatunków API ze ścieżkami TMDB v3: ID gatunków filmów i seriali z nazwami w 14 językach oraz słowniki krajów, języków, stanowisk i dostawców streamingu.
- [API obrazów i host obrazów](https://amodb.dev/pl/images-api/): API obrazów filmów ze ścieżkami TMDB v3: wypisz plakaty, tła, loga i kadry każdego tytułu, a potem ładuj je z img.amodb.dev w 10 rozmiarach bez klucza.
- [API wideo i zwiastunów](https://amodb.dev/pl/videos-trailers/): API wideo filmów ze ścieżkami TMDB v3: wypisz zwiastuny, teasery, klipy i featurette filmu lub serialu, a potem filtruj według typu i języka w kodzie.
- [API tłumaczeń](https://amodb.dev/pl/translations/): API tłumaczeń filmów ze ścieżkami TMDB v3: odczytaj wszystkie zapisane tytuły, opisy i slogany filmu, serialu lub odcinka we wszystkich językach naraz.
- [API słów kluczowych](https://amodb.dev/pl/keywords/): API słów kluczowych ze ścieżkami TMDB v3: tagi fabularne filmu lub serialu, szczegóły słowa kluczowego, jego filmy i łączenie ID z with_keywords w discover.
- [API kolekcji](https://amodb.dev/pl/collections/): API kolekcji filmów ze ścieżkami TMDB v3: pobierz franczyzę po ID ze wszystkimi filmami, odczytaj belongs_to_collection w filmie i szukaj kolekcji po nazwie.
- [Firmy i sieci telewizyjne](https://amodb.dev/pl/companies-networks/): Firmy produkcyjne i sieci telewizyjne przez ścieżki TMDB v3. Odczytaj nazwę, kraj i logo po ID, a potem filtruj discover według ID firmy lub sieci.
- [Oceny filmów i seriali](https://amodb.dev/pl/ratings/): API ocen filmów zwraca wyniki z IMDb, Kinopoisk, Metacritic, Rotten Tomatoes i TMDB dla tytułu jednym wywołaniem, z null dla każdego nieznanego źródła.
- [Wyszukiwanie po zewnętrznym ID](https://amodb.dev/pl/find-by-external-id/): Znajdź film, serial lub osobę po ID z IMDb, TVDB, Wikidata lub Kinopoisk przez endpoint find z TMDB oraz odczytaj zewnętrzne ID i fakty z Wikidata o tytule.
- [Endpoint zgodny z OMDb](https://amodb.dev/pl/omdb-endpoint/): Endpoint zgodny z OMDb API pod api.amodb.dev/omdb/. Szukaj przez i lub t, wyszukuj przez s, czytaj tablicę Ratings i zachowaj klienta, zmieniając bazowy URL.
- [Mierniki nastroju](https://amodb.dev/pl/moods/): API nastrojów z miernikami na skali od 0 do 10. Odczytaj nastroje filmu lub serialu, scal je przez append_to_response=moods i zbuduj plakietki albo filtry.
- [Ścieżki dźwiękowe](https://amodb.dev/pl/soundtracks/): API ścieżek dźwiękowych filmów zwraca album soundtracku filmu lub serialu z listą utworów. Wywołaj endpoint albo dodaj append_to_response=soundtracks.
- [Seanse kinowe](https://amodb.dev/pl/showtimes/): API seansów filmu zwraca kina i godziny seansów w jednym kraju albo podsumowanie krajów. Scal je ze szczegółami przez append_to_response lub z now_playing.

### Zasoby

- [Dziennik zmian](https://amodb.dev/pl/changelog/): Datowana lista zmian w API amodb, hoście obrazów img.amodb.dev, planach i na stronie. Nowe wpisy są na górze, z opisem zmiany i tym, co musisz zrobić.

- [Status](https://amodb.dev/pl/status/): Jak sprawdzić, czy amodb działa: publiczny endpoint health, kody błędów wskazujące awarię i jak zgłosić problem z danymi, których potrzebujemy do diagnozy.

- [Dokumentacja API](https://amodb.dev/pl/reference/): Każdy endpoint amodb ze ścieżką, parametrami, przykładami żądań w pięciu językach i prawdziwą odpowiedzią JSON. Zgodność z TMDB v3 i OMDb.

- [Poradniki](https://amodb.dev/pl/tutorials/): Poradniki krok po kroku do API amodb: wyszukiwanie, szczegóły, obrazy, języki i OMDb w popularnych technologiach, z kodem do skopiowania i uruchomienia.

- [Porównaj amodb](https://amodb.dev/pl/compare/): Zestawienia amodb z innymi API metadanych filmów i seriali: zgodność, języki, limity, obrazy i ceny, z liczbami, które możesz sprawdzić.

- [Zastosowania](https://amodb.dev/pl/use-cases/): Jak zespoły używają amodb do danych o filmach i serialach: katalogi, serwery multimediów, rekomendacje, boty i badania, z potrzebnymi endpointami i limitami.

## Powiązane strony

- [Szybki start](https://amodb.dev/pl/quickstart/): Pierwsze wywołanie amodb: zdobądź klucz, pobierz szczegóły filmu w curl, JavaScript, Python, PHP lub Go, potem załaduj plakat z img.amodb.dev. Poniżej 2 minut.
- [Uwierzytelnianie](https://amodb.dev/pl/authentication/): Jak wysłać klucz amodb: api_key w zapytaniu, nagłówek Authorization Bearer albo apikey dla wywołań OMDb. Format klucza, przechowywanie, rotacja i błędy 401.
- [Cennik](https://amodb.dev/pl/pricing/): Plany amodb płatne z góry różnią się tylko limitem żądań na minutę: 20, 40 lub 120. Każdy plan ma wszystkie dane TMDB v3 i OMDb. Bez odnowień i okresu próbnego.

Zaktualizowano: 2026-10-18. Source: https://amodb.dev/pl/docs/
