# Documentația amodb

> Începe cu ghidul rapid ca să faci primul apel în două minute. Apoi citește cum funcționează cheile, limitele de cereri, erorile, limbile și imaginile. amodb păstrează căile și JSON-ul TMDB v3 și OMDb, așa că majoritatea paginilor de aici explică ce este la fel, ce adaugă amodb și puținele locuri unde diferă.

## URL-uri de bază

| Utilizare            | URL de bază                               | Parametrul cheii                      |
| -------------------- | ----------------------------------------- | ------------------------------------- |
| Stil TMDB v3         | `https://api.amodb.dev/3`                 | `api_key` sau `Authorization: Bearer` |
| Stil OMDb            | `https://api.amodb.dev/omdb/`             | `apikey`                              |
| Imagini              | `https://img.amodb.dev/t/p/{size}/{file}` | niciunul                              |
| Catalogul de planuri | `https://api.amodb.dev/plans`             | niciunul                              |

### Primii pași

- [Ghid rapid](https://amodb.dev/ro/quickstart/): Fă primul apel amodb: ia o cheie, cere detaliile unui film în curl, JavaScript, Python, PHP sau Go, apoi încarcă posterul de pe img.amodb.dev. Sub 2 minute.
- [Autentificare](https://amodb.dev/ro/authentication/): Cum trimiți cheia amodb: api_key în interogare, antetul Authorization Bearer sau apikey pentru apelurile OMDb. Format, stocare, rotire și erorile 401.

### Concepte

- [Limite de cereri](https://amodb.dev/ro/rate-limits/): amodb limitează fiecare cheie în cereri pe minut, în fereastră glisantă de 60 de secunde: 20, 40 sau 120. Citește antetele și tratează 429 cu Retry-After.
- [Erori](https://amodb.dev/ro/errors/): Fiecare eroare amodb, cu statusul HTTP, status_code TMDB și mesajul, plus forma erorii OMDb. Ce înseamnă fiecare și ce ar trebui să facă clientul tău.
- [Limbi](https://amodb.dev/ro/languages/): amodb servește titluri, descrieri și nume în 14 limbi. Trimite în language o etichetă în stil TMDB, precum ru-RU sau pt-BR; altă etichetă revine la engleză.
- [Imagini](https://amodb.dev/ro/images/): Încarcă postere, imagini de fundal și profiluri de pe img.amodb.dev cu căile și dimensiunile TMDB, de la w92 la original. Fără cheie, cache 30 de zile.

### Referință API

- [API detalii film](https://amodb.dev/ro/movies/): API detalii film cu aceleași căi și același JSON ca TMDB v3. Preia un film după ID, adaugă credite, evaluări și atmosferă cu append_to_response, în 14 limbi.
- [API seriale TV](https://amodb.dev/ro/tv-series/): API seriale TV cu căile și JSON-ul TMDB v3. Preia un serial după ID cu sezoane, rețele și următorul episod, plus clasificări de conținut și furnizori.
- [API sezoane și episoade TV](https://amodb.dev/ro/tv-seasons-episodes/): API sezoane și episoade TV cu aceleași căi și același JSON ca TMDB v3. Citește un sezon cu toate episoadele sau un episod cu data difuzării, durata și cadrul.
- [API detalii persoană](https://amodb.dev/ro/people/): API detalii persoană cu căile și JSON-ul TMDB v3. Preia un actor sau membru al echipei după ID, cu biografie, filmografie, ID-uri externe și lista populară.
- [API credite](https://amodb.dev/ro/credits/): API credite cu aceleași căi și același JSON ca TMDB v3. Distribuția și echipa pentru filme, seriale, sezoane și episoade, cu order, department și job.
- [API căutare](https://amodb.dev/ro/search/): API căutare cu căile și JSON-ul TMDB v3. Găsește filme, seriale, persoane, colecții, companii și cuvinte-cheie după text, cu filtre de an și paginare.
- [API discover](https://amodb.dev/ro/discover/): API discover cu filtrele TMDB v3. Listează filme și seriale după gen, distribuție, companie, cuvânt-cheie, an, evaluare, durată și furnizor, cu sortare.
- [Endpoint-uri pentru tendințe și liste](https://amodb.dev/ro/trending-lists/): API filme în tendințe cu căi TMDB v3: topuri pe zi și săptămână, plus now playing, populare, bine cotate și viitoare pentru filme și TV, în cache 30 de minute.
- [Genuri și liste de referință](https://amodb.dev/ro/genres/): API listă de genuri cu căi TMDB v3: ID-uri de gen pentru filme și TV cu nume traduse, plus liste de țări, limbi, meserii, clasificări și furnizori de vizionare.
- [API imagini și gazdă de imagini](https://amodb.dev/ro/images-api/): API imagini filme cu căi TMDB v3: listează postere, imagini de fundal, logouri și cadre, apoi încarcă-le de la img.amodb.dev în 10 dimensiuni, fără cheie.
- [API videoclipuri și trailere](https://amodb.dev/ro/videos-trailers/): API videoclipuri filme cu căi TMDB v3: listează trailere, teasere, clipuri și featurette-uri ale unui film sau serial, apoi filtrează după tip și limbă în cod.
- [API traduceri](https://amodb.dev/ro/translations/): API traduceri filme cu căi TMDB v3: citește fiecare titlu, descriere și slogan stocat al unui film, serial sau episod în toate limbile deodată.
- [API cuvinte-cheie](https://amodb.dev/ro/keywords/): API cuvinte-cheie cu căi TMDB v3: listează etichetele unui film sau serial, caută un cuvânt-cheie, listează filmele lui și combină ID-urile cu with_keywords.
- [API colecții](https://amodb.dev/ro/collections/): API colecții de filme cu căi TMDB v3: preia o franciză după ID cu toate părțile, citește belongs_to_collection la un film și caută colecții după nume.
- [Companii și rețele](https://amodb.dev/ro/companies-networks/): Caută companii de producție și rețele TV cu căi TMDB v3. Citește numele, țara și logoul după ID, apoi filtrează discover după ID-ul unei companii sau rețele.
- [Evaluări pentru filme și TV](https://amodb.dev/ro/ratings/): API evaluări filme ce întoarce scorurile IMDb, Kinopoisk, Metacritic, Rotten Tomatoes și TMDB pentru un titlu într-un apel, cu null pentru sursele necunoscute.
- [Căutare după ID extern](https://amodb.dev/ro/find-by-external-id/): Caută un film, serial sau o persoană după ID IMDb, TVDB, Wikidata sau Kinopoisk cu endpoint-ul find și citește ID-urile externe și faptele Wikidata.
- [Endpoint compatibil OMDb](https://amodb.dev/ro/omdb-endpoint/): Endpoint compatibil OMDb la api.amodb.dev/omdb/. Caută după i sau t, caută cu s, citește array-ul Ratings și păstrează-ți clientul schimbând URL-ul de bază.
- [Indicatori de atmosferă](https://amodb.dev/ro/moods/): API atmosferă filme cu indicatori de la 0 la 10 pe titlu. Citește atmosferele unui film, îmbină-le cu append_to_response=moods, construiește insigne sau filtre.
- [Coloane sonore](https://amodb.dev/ro/soundtracks/): API coloană sonoră ce întoarce albumul coloanei sonore a unui film sau serial, cu piesele. Apelează endpoint-ul sau adaugă append_to_response=soundtracks.
- [Program de proiecții în cinema](https://amodb.dev/ro/showtimes/): API program proiecții: cinematografe și ore ale unui film într-o țară, sau un rezumat pe țări. Îmbină-l în detalii sau combină-l cu now_playing.

### Resurse

- [Jurnal de modificări](https://amodb.dev/ro/changelog/): Modificările API-ului amodb, ale gazdei img.amodb.dev, ale planurilor și ale site-ului, pe date. Cele noi apar primele, cu ce s-a schimbat și ce ai de făcut.

- [Stare](https://amodb.dev/ro/status/): Cum verifici dacă amodb funcționează: endpoint-ul public de health, codurile de eroare care indică un incident și cum raportezi o problemă cu detalii utile.

- [Referință API](https://amodb.dev/ro/reference/): Fiecare endpoint amodb cu calea, parametrii, exemple de cereri în cinci limbaje și un răspuns JSON real. Compatibil TMDB v3 și OMDb.

- [Tutoriale](https://amodb.dev/ro/tutorials/): Tutoriale pas cu pas pentru API-ul amodb: căutare, detalii, imagini, limbi și apeluri OMDb în stack-uri uzuale, fiecare cu cod pe care îl poți copia și rula.

- [Compară amodb](https://amodb.dev/ro/compare/): Comparații directe între amodb și alte API-uri de metadate pentru filme și TV: compatibilitate, limbi, limite, imagini și prețuri, cu cifre verificabile.

- [Cazuri de utilizare](https://amodb.dev/ro/use-cases/): Cum folosesc echipele amodb pentru date de filme și TV: cataloage, servere media, recomandări, boți și cercetare, cu endpoint-urile și limitele fiecărui caz.

## Pagini conexe

- [Ghid rapid](https://amodb.dev/ro/quickstart/): Fă primul apel amodb: ia o cheie, cere detaliile unui film în curl, JavaScript, Python, PHP sau Go, apoi încarcă posterul de pe img.amodb.dev. Sub 2 minute.
- [Autentificare](https://amodb.dev/ro/authentication/): Cum trimiți cheia amodb: api_key în interogare, antetul Authorization Bearer sau apikey pentru apelurile OMDb. Format, stocare, rotire și erorile 401.
- [Prețuri](https://amodb.dev/ro/pricing/): Planurile amodb diferă doar prin cereri pe minut: 20, 40 sau 120. Toate includ datele compatibile TMDB v3 și OMDb. Plată în avans, fără reînnoire sau probă.

Actualizat: 2026-10-18. Source: https://amodb.dev/ro/docs/
