API: Entdecken und Titel

GET /api/arr/{media_type}/options may change

Quality profiles and target folders

For the choice shown before adding something. Profiles blocked for this account are not returned at all, rather than being offered and refused later.

Felder und Aufbau

Parameter

media_typemovie | tv path Pflicht

tierstandard | uhd query

Antwort

FeldArt

quality_profilesListe von ArrOption Pflicht

root_foldersListe von ArrRootFolder Pflicht

default_quality_profile_idZahl oder null

default_root_folderText oder null

root_folder_choiceja/nein

quality_profile_choiceja/nein

Aufbau der Antwort

{
  "quality_profiles": [
    {
      "id": "number",
      "name": "string"
    }
  ],
  "root_folders": [
    {
      "path": "string",
      "free_space": "number | null"
    }
  ],
  "default_quality_profile_id": "number | null",
  "default_root_folder": "string | null",
  "root_folder_choice": "boolean",
  "quality_profile_choice": "boolean"
}

GET /api/browse/{media_type} may change

Everything under a keyword or studio

All titles for one keyword or one studio, paged.

Felder und Aufbau

Parameter

media_typemovie | tv path Pflicht

keyword_idZahl oder null query

company_idZahl oder null query

pageZahl query

Antwort

FeldArt

labelText Pflicht

pageMediaPage Pflicht

Aufbau der Antwort

{
  "label": "string",
  "page": {
    "page": "number",
    "total_pages": "number",
    "total_results": "number",
    "items": [
      {}
    ],
    "demo": "boolean",
    "arr_warning": "string | null"
  }
}

GET /api/calendar may change

What arrives when

What appears in the given period - your own holdings and new releases. There is deliberately no region parameter: the region comes from the profile, so a calendar cannot show dates for a country the viewer does not live in.

Felder und Aufbau

Parameter

date_fromText oder null query

date_toText oder null query

sourcesall | mine | new query

date_typedigital | kino query

noisesinnvoll | studios | known | none query

Antwort

FeldArt

date_fromText Pflicht

date_toText Pflicht

daysListe von CalendarDay

arr_warningText oder null

tmdb_warningText oder null

demoja/nein

Aufbau der Antwort

{
  "date_from": "string",
  "date_to": "string",
  "days": [
    {
      "date": "string",
      "entries": [
        {}
      ]
    }
  ],
  "arr_warning": "string | null",
  "tmdb_warning": "string | null",
  "demo": "boolean"
}

GET /api/detail/tv/{tmdb_id}/season/{season_number} may change

Episodes of one season

The episodes of a season, including which of them are already here.

Felder und Aufbau

Parameter

tmdb_idZahl path Pflicht

season_numberZahl path Pflicht

Antwort

FeldArt

season_numberZahl Pflicht

nameText Pflicht

overviewText

air_dateText oder null

episodesListe von EpisodeInfo

Aufbau der Antwort

{
  "season_number": "number",
  "name": "string",
  "overview": "string",
  "air_date": "string | null",
  "episodes": [
    {
      "episode_number": "number",
      "name": "string",
      "overview": "string",
      "air_date": "string | null",
      "runtime_minutes": "number | null",
      "still_url": "string | null",
      "vote_average": "number",
      "available": "boolean"
    }
  ]
}

GET /api/detail/{media_type}/{tmdb_id} may change

Everything about one title

Cast, studios, keywords and recommendations, plus whether it is already in the library.

Felder und Aufbau

Parameter

media_typemovie | tv path Pflicht

tmdb_idZahl path Pflicht

Antwort

FeldArt

media_typemovie | tv Pflicht

tmdb_idZahl Pflicht

tvdb_idZahl oder null

titleText Pflicht

original_titleText oder null

overviewText

poster_urlText oder null

backdrop_urlText oder null

release_dateText oder null

vote_averageZahl

vote_countZahl

genresListe von Text

runtime_minutesZahl oder null

certificationText oder null

original_languageText oder null

origin_countryListe von Text

seasonsListe von SeasonInfo

statusText

status_uhdText oder null

watchedja/nein

watched_onListe von Text

watched_not_onListe von Text

pathText oder null

path_uhdText oder null

uhd_in_standardja/nein

taglineText

homepageText oder null

status_textText

original_countryListe von Text

spoken_languagesListe von Text

budgetZahl oder null

revenueZahl oder null

studiosListe von NamedRef

keywordsListe von NamedRef

trailerTrailer oder null

watchWatchProviders oder null

in_my_subscriptionsListe von Text

watchingja/nein

requested_by_meja/nein

my_feedbackMeineRueckmeldung oder null

open_ticketja/nein

castListe von CastMember

crewListe von CrewMember

recommendationsListe von MediaItem

seasons_totalZahl oder null

episodes_totalZahl oder null

series_statusText

networksListe von NamedRef

Aufbau der Antwort

{
  "media_type": "movie | tv",
  "tmdb_id": "number",
  "tvdb_id": "number | null",
  "title": "string",
  "original_title": "string | null",
  "overview": "string",
  "poster_url": "string | null",
  "backdrop_url": "string | null",
  "release_date": "string | null",
  "vote_average": "number",
  "vote_count": "number",
  "genres": [
    "string"
  ],
  "runtime_minutes": "number | null",
  "certification": "string | null"
}

GET /api/detail/{media_type}/{tmdb_id}/recommendations may change

A different set of recommendations

For the "show me others" button. The pool is fixed and always sorted the same way; runde only cuts a different slice out of it, so the button cannot loop.

Felder und Aufbau

Parameter

media_typemovie | tv path Pflicht

tmdb_idZahl path Pflicht

rundeZahl query

Antwort

FeldArt

itemsListe von MediaItem Pflicht

rundeZahl Pflicht

rundenZahl Pflicht

Aufbau der Antwort

{
  "items": [
    {
      "media_type": "movie | tv",
      "tmdb_id": "number",
      "tvdb_id": "number | null",
      "title": "string",
      "original_title": "string | null",
      "overview": "string",
      "poster_url": "string | null",
      "backdrop_url": "string | null",
      "release_date": "string | null",
      "vote_average": "number",
      "vote_count": "number",
      "genres": [
        "string"
      ],
      "runtime_minutes": "number | null",
      "certification": "string | null"
    }
  ],
  "runde": "number",
  "runden": "number"
}

GET /api/discover/{media_type} may change

Discover titles

Browsable lists of movies or shows with the usual filters - genre, year, rating, provider.

Felder und Aufbau

Parameter

media_typemovie | tv path Pflicht

date_fromText oder null query

date_toText oder null query

languageText oder null query

regionText oder null query

genre_idZahl oder null query

sortnewest | rating | popular query

pageZahl query

feature_lengthja/nein query

min_ratingZahl oder null query

hide_unratedja/nein query

released_in_regionja/nein query

studio_idZahl oder null query

known_onlyja/nein query

Antwort

FeldArt

pageZahl Pflicht

total_pagesZahl Pflicht

total_resultsZahl Pflicht

itemsListe von MediaItem Pflicht

demoja/nein

arr_warningText oder null

Aufbau der Antwort

{
  "page": "number",
  "total_pages": "number",
  "total_results": "number",
  "items": [
    {
      "media_type": "movie | tv",
      "tmdb_id": "number",
      "tvdb_id": "number | null",
      "title": "string",
      "original_title": "string | null",
      "overview": "string",
      "poster_url": "string | null",
      "backdrop_url": "string | null",
      "release_date": "string | null",
      "vote_average": "number",
      "vote_count": "number",
      "genres": [
        "string"
      ],
      "runtime_minutes": "number | null",
      "certification": "string | null"
    }
  ],
  "demo": "boolean",
  "arr_warning": "string | null"
}

GET /api/favorites may change

Your own marked titles

Filtered by the age limit of the calling account. The filtering is necessary because title and image come from Nexview's own table here, not from TMDB, and would otherwise bypass the check.

Felder und Aufbau

Antwort

FeldArt

media_typemovie | tv Pflicht

tmdb_idZahl Pflicht

titleText Pflicht

poster_urlText oder null Pflicht

created_atZeitpunkt (ISO 8601) Pflicht

Aufbau der Antwort

[
  {
    "media_type": "movie | tv",
    "tmdb_id": "number",
    "title": "string",
    "poster_url": "string | null",
    "created_at": "ISO 8601"
  }
]

POST /api/favorites may change

Mark a title

Marking something twice is not an error.

Felder und Aufbau

Anfragekörper

FeldArt

media_typemovie | tv Pflicht

tmdb_idZahl Pflicht

titleText

poster_urlText oder null

Antwort

FeldArt

media_typemovie | tv Pflicht

tmdb_idZahl Pflicht

titleText Pflicht

poster_urlText oder null Pflicht

created_atZeitpunkt (ISO 8601) Pflicht

Aufbau der Antwort

{
  "media_type": "movie | tv",
  "tmdb_id": "number",
  "title": "string",
  "poster_url": "string | null",
  "created_at": "ISO 8601"
}

GET /api/favorites/people may change

Your own marked people

Newest first.

Felder und Aufbau

Antwort

FeldArt

person_idZahl Pflicht

nameText Pflicht

photo_urlText oder null Pflicht

departmentText Pflicht

created_atZeitpunkt (ISO 8601) Pflicht

Aufbau der Antwort

[
  {
    "person_id": "number",
    "name": "string",
    "photo_url": "string | null",
    "department": "string",
    "created_at": "ISO 8601"
  }
]

POST /api/favorites/people may change

Mark a person

Doing it twice is not an error.

Felder und Aufbau

Anfragekörper

FeldArt

person_idZahl Pflicht

nameText

photo_urlText oder null

departmentText

Antwort

FeldArt

person_idZahl Pflicht

nameText Pflicht

photo_urlText oder null Pflicht

departmentText Pflicht

created_atZeitpunkt (ISO 8601) Pflicht

Aufbau der Antwort

{
  "person_id": "number",
  "name": "string",
  "photo_url": "string | null",
  "department": "string",
  "created_at": "ISO 8601"
}

DELETE /api/favorites/people/{person_id} may change

Unmark a person

Removes the person from your favourites.

Felder und Aufbau

Parameter

person_idZahl path Pflicht

DELETE /api/favorites/{media_type}/{tmdb_id} may change

Unmark a title

What was not marked stays unmarked - no error.

Felder und Aufbau

Parameter

media_typemovie | tv path Pflicht

tmdb_idZahl path Pflicht

GET /api/genres/{media_type} may change

Available genres

The genres TMDB knows for this media type, in the language of the calling account.

Felder und Aufbau

Parameter

media_typemovie | tv path Pflicht

Antwort

FeldArt

idZahl Pflicht

nameText Pflicht

Aufbau der Antwort

[
  {
    "id": "number",
    "name": "string"
  }
]

GET /api/home/curated may change

Recommendations based on your favourites

Only what is not already here. Movies and shows - the first version looked at movies only, which left anyone who marks only shows with an empty row.

Felder und Aufbau

Antwort

FeldArt

has_favoritesja/nein Pflicht

itemsListe von MediaItem Pflicht

Aufbau der Antwort

{
  "has_favorites": "boolean",
  "items": [
    {
      "media_type": "movie | tv",
      "tmdb_id": "number",
      "tvdb_id": "number | null",
      "title": "string",
      "original_title": "string | null",
      "overview": "string",
      "poster_url": "string | null",
      "backdrop_url": "string | null",
      "release_date": "string | null",
      "vote_average": "number",
      "vote_count": "number",
      "genres": [
        "string"
      ],
      "runtime_minutes": "number | null",
      "certification": "string | null"
    }
  ]
}

GET /api/home/recent may change

Recently arrived

Titles that finished downloading, visible to everyone. ⚠️ Each entry also names who requested it. That is wanted inside a household and may not be wanted on a wall-mounted screen. Plot and backdrop come from TMDB; if that fails, the entries stay but look plainer.

Felder und Aufbau

Antwort

FeldArt

request_idZahl Pflicht

media_typemovie | tv Pflicht

tmdb_idZahl Pflicht

titleText Pflicht

overviewText

poster_urlText oder null

backdrop_urlText oder null

release_dateText oder null

vote_averageZahl

runtime_minutesZahl oder null

genresListe von Text

completed_atZeitpunkt (ISO 8601) oder null

requested_byText Pflicht

requester_avatarText oder null

seasonsListe von Zahl

Aufbau der Antwort

[
  {
    "request_id": "number",
    "media_type": "movie | tv",
    "tmdb_id": "number",
    "title": "string",
    "overview": "string",
    "poster_url": "string | null",
    "backdrop_url": "string | null",
    "release_date": "string | null",
    "vote_average": "number",
    "runtime_minutes": "number | null",
    "genres": [
      "string"
    ],
    "completed_at": "ISO 8601 | null",
    "requested_by": "string",
    "requester_avatar": "string | null"
  }
]

GET /api/home/trending may change

What is popular right now

Without the things that are already here. Deliberately filtered: a suggestion you can neither request nor want, because it is already downloaded, is not a suggestion.

Felder und Aufbau

Antwort

FeldArt

media_typemovie | tv Pflicht

tmdb_idZahl Pflicht

tvdb_idZahl oder null

titleText Pflicht

original_titleText oder null

overviewText

poster_urlText oder null

backdrop_urlText oder null

release_dateText oder null

vote_averageZahl

vote_countZahl

genresListe von Text

runtime_minutesZahl oder null

certificationText oder null

original_languageText oder null

origin_countryListe von Text

seasonsListe von SeasonInfo

statusText

status_uhdText oder null

watchedja/nein

watched_onListe von Text

watched_not_onListe von Text

pathText oder null

path_uhdText oder null

uhd_in_standardja/nein

Aufbau der Antwort

[
  {
    "media_type": "movie | tv",
    "tmdb_id": "number",
    "tvdb_id": "number | null",
    "title": "string",
    "original_title": "string | null",
    "overview": "string",
    "poster_url": "string | null",
    "backdrop_url": "string | null",
    "release_date": "string | null",
    "vote_average": "number",
    "vote_count": "number",
    "genres": [
      "string"
    ],
    "runtime_minutes": "number | null",
    "certification": "string | null"
  }
]

GET /api/media/{media_type}/{tmdb_id} may change

Details for one title

Overview, cast, ratings, runtime, and whether it is already in the library.

Felder und Aufbau

Parameter

media_typemovie | tv path Pflicht

tmdb_idZahl path Pflicht

Antwort

FeldArt

media_typemovie | tv Pflicht

tmdb_idZahl Pflicht

tvdb_idZahl oder null

titleText Pflicht

original_titleText oder null

overviewText

poster_urlText oder null

backdrop_urlText oder null

release_dateText oder null

vote_averageZahl

vote_countZahl

genresListe von Text

runtime_minutesZahl oder null

certificationText oder null

original_languageText oder null

origin_countryListe von Text

seasonsListe von SeasonInfo

statusText

status_uhdText oder null

watchedja/nein

watched_onListe von Text

watched_not_onListe von Text

pathText oder null

path_uhdText oder null

uhd_in_standardja/nein

Aufbau der Antwort

{
  "media_type": "movie | tv",
  "tmdb_id": "number",
  "tvdb_id": "number | null",
  "title": "string",
  "original_title": "string | null",
  "overview": "string",
  "poster_url": "string | null",
  "backdrop_url": "string | null",
  "release_date": "string | null",
  "vote_average": "number",
  "vote_count": "number",
  "genres": [
    "string"
  ],
  "runtime_minutes": "number | null",
  "certification": "string | null"
}

GET /api/people may change

People to browse and search

Filtered by department, paged. Without q, the most-asked-about people of that department.

Felder und Aufbau

Parameter

qText query

departmentacting | directing | writing query

pageZahl query

Antwort

FeldArt

itemsListe von PersonSummary Pflicht

has_moreja/nein Pflicht

Aufbau der Antwort

{
  "items": [
    {
      "person_id": "number",
      "name": "string",
      "photo_url": "string | null",
      "department": "string",
      "known_for": "string"
    }
  ],
  "has_more": "boolean"
}

GET /api/person/{person_id} may change

One person

Photo, biography and their best-known titles.

Felder und Aufbau

Parameter

person_idZahl path Pflicht

Antwort

FeldArt

person_idZahl Pflicht

nameText Pflicht

biographyText

photo_urlText oder null

birthdayText oder null

deathdayText oder null

place_of_birthText oder null

known_for_departmentText

creditsListe von PersonCredit

Aufbau der Antwort

{
  "person_id": "number",
  "name": "string",
  "biography": "string",
  "photo_url": "string | null",
  "birthday": "string | null",
  "deathday": "string | null",
  "place_of_birth": "string | null",
  "known_for_department": "string",
  "credits": [
    {
      "media_type": "movie | tv",
      "tmdb_id": "number",
      "kind": "string",
      "title": "string",
      "character": "string",
      "poster_url": "string | null",
      "release_date": "string | null",
      "vote_average": "number",
      "status": "string",
      "watched": "boolean",
      "status_uhd": "string | null",
      "watched_on": [
        "string"
      ],
      "watched_not_on": [
        "string"
      ]
    }
  ]
}

GET /api/ratings/movie may change

Ratings for several movies at once

Deliberately its own call rather than part of the lists: the values come from Radarr, and twenty round trips would slow a page down for something nobody looks at first.

Felder und Aufbau

Parameter

idsText query Pflicht

GET /api/search/{media_type} may change

Search movies or shows

Finds titles by name. Results are paged and come from TMDB in the language of the calling account.

Felder und Aufbau

Parameter

media_typemovie | tv path Pflicht

qText query Pflicht

pageZahl query

Antwort

FeldArt

pageZahl Pflicht

total_pagesZahl Pflicht

total_resultsZahl Pflicht

itemsListe von MediaItem Pflicht

demoja/nein

arr_warningText oder null

Aufbau der Antwort

{
  "page": "number",
  "total_pages": "number",
  "total_results": "number",
  "items": [
    {
      "media_type": "movie | tv",
      "tmdb_id": "number",
      "tvdb_id": "number | null",
      "title": "string",
      "original_title": "string | null",
      "overview": "string",
      "poster_url": "string | null",
      "backdrop_url": "string | null",
      "release_date": "string | null",
      "vote_average": "number",
      "vote_count": "number",
      "genres": [
        "string"
      ],
      "runtime_minutes": "number | null",
      "certification": "string | null"
    }
  ],
  "demo": "boolean",
  "arr_warning": "string | null"
}

POST /api/stoebern/filmabend/ergebnis/{media_type} may change

Turn the answers into a shortlist

runde is the "roll again": the same answers in the same round always give the same stack, so going back and forth does not reshuffle what somebody was about to pick.

Felder und Aufbau

Parameter

media_typemovie | tv path Pflicht

Anfragekörper

FeldArt

antwortenObjekt Pflicht

rundeZahl

Antwort

FeldArt

itemsListe von MediaItem Pflicht

rundeZahl Pflicht

antwortenObjekt Pflicht

quelle_leerja/nein

erschoepftja/nein

demoja/nein

Aufbau der Antwort

{
  "items": [
    {
      "media_type": "movie | tv",
      "tmdb_id": "number",
      "tvdb_id": "number | null",
      "title": "string",
      "original_title": "string | null",
      "overview": "string",
      "poster_url": "string | null",
      "backdrop_url": "string | null",
      "release_date": "string | null",
      "vote_average": "number",
      "vote_count": "number",
      "genres": [
        "string"
      ],
      "runtime_minutes": "number | null",
      "certification": "string | null"
    }
  ],
  "runde": "number",
  "antworten": "object",
  "quelle_leer": "boolean",
  "erschoepft": "boolean",
  "demo": "boolean"
}

GET /api/stoebern/filmabend/fragen/{media_type} may change

The whole question tree

Tailored to this person and delivered at once. The interface walks it itself - a round trip per question would be too slow for something meant to feel like a conversation.

Felder und Aufbau

Parameter

media_typemovie | tv path Pflicht

Antwort

FeldArt

kennungText Pflicht

antwortenListe von Text Pflicht

entfaellt_wennObjekt Pflicht

antworten_entfallen_wennObjekt

Aufbau der Antwort

[
  {
    "kennung": "string",
    "antworten": [
      "string"
    ],
    "entfaellt_wenn": "object",
    "antworten_entfallen_wenn": "object"
  }
]

GET /api/stoebern/filter/{media_type} may change

Filter in plain questions

Six human questions instead of thirteen sliders. Deliberately not bolted onto discover: that page stays as it is.

Felder und Aufbau

Parameter

media_typemovie | tv path Pflicht

zeitegal | kurz | mittel | lang query

genresText oder null query

ohne_genresText oder null query

epocheText query

bekanntheitegal | bekannt | geheimtipp query

sortierungrating | popular | newest query

bestandegal | nur_vorhanden | nur_neu query

pageZahl query

anzahlZahl query

Antwort

FeldArt

itemsListe von MediaItem Pflicht

pageZahl Pflicht

total_pagesZahl Pflicht

seiten_durchsuchtZahl Pflicht

erschoepftja/nein Pflicht

jahrzehnteListe von Zahl

demoja/nein

arr_warningText oder null

Aufbau der Antwort

{
  "items": [
    {
      "media_type": "movie | tv",
      "tmdb_id": "number",
      "tvdb_id": "number | null",
      "title": "string",
      "original_title": "string | null",
      "overview": "string",
      "poster_url": "string | null",
      "backdrop_url": "string | null",
      "release_date": "string | null",
      "vote_average": "number",
      "vote_count": "number",
      "genres": [
        "string"
      ],
      "runtime_minutes": "number | null",
      "certification": "string | null"
    }
  ],
  "page": "number",
  "total_pages": "number",
  "seiten_durchsucht": "number",
  "erschoepft": "boolean",
  "jahrzehnte": [
    "number"
  ],
  "demo": "boolean",
  "arr_warning": "string | null"
}

GET /api/stoebern/regal/{media_type}/{kennung} may change

The contents of one shelf

bestand filters by what is already here on the server. The discover page filters in the browser first, which on a full library leaves visible gaps in the grid.

Felder und Aufbau

Parameter

media_typemovie | tv path Pflicht

kennungText path Pflicht

pageZahl query

bestandegal | nur_vorhanden | nur_neu query

anzahlZahl query

Antwort

FeldArt

kennungText Pflicht

itemsListe von MediaItem Pflicht

pageZahl Pflicht

total_pagesZahl Pflicht

seiten_durchsuchtZahl Pflicht

erschoepftja/nein Pflicht

demoja/nein

arr_warningText oder null

Aufbau der Antwort

{
  "kennung": "string",
  "items": [
    {
      "media_type": "movie | tv",
      "tmdb_id": "number",
      "tvdb_id": "number | null",
      "title": "string",
      "original_title": "string | null",
      "overview": "string",
      "poster_url": "string | null",
      "backdrop_url": "string | null",
      "release_date": "string | null",
      "vote_average": "number",
      "vote_count": "number",
      "genres": [
        "string"
      ],
      "runtime_minutes": "number | null",
      "certification": "string | null"
    }
  ],
  "page": "number",
  "total_pages": "number",
  "seiten_durchsucht": "number",
  "erschoepft": "boolean",
  "demo": "boolean",
  "arr_warning": "string | null"
}

GET /api/stoebern/regale/{media_type} may change

Which shelves exist

Without a single TMDB call. The titles inside are fetched per shelf afterwards, so the overview appears immediately instead of waiting on a dozen lookups.

Felder und Aufbau

Parameter

media_typemovie | tv path Pflicht

Antwort

FeldArt

kennungText Pflicht

gruppeText Pflicht

kategorieText Pflicht

persoenlichja/nein Pflicht

titelText oder null

Aufbau der Antwort

[
  {
    "kennung": "string",
    "gruppe": "string",
    "kategorie": "string",
    "persoenlich": "boolean",
    "titel": "string | null"
  }
]

GET /api/streaming may change

Streaming providers

The catalogue for the region, the account's own selection, and where that region came from.

Felder und Aufbau

Antwort

FeldArt

regionText Pflicht

region_selbst_gewaehltja/nein Pflicht

diensteListe von DienstOut Pflicht

meineListe von Text Pflicht

Aufbau der Antwort

{
  "region": "string",
  "region_selbst_gewaehlt": "boolean",
  "dienste": [
    {
      "slug": "string",
      "name": "string",
      "logo_url": "string | null"
    }
  ],
  "meine": [
    "string"
  ]
}

PUT /api/streaming may change

Replace your provider selection

Replaces the whole selection rather than changing one entry. One tick more or less is the same operation as "deselect everything".

Felder und Aufbau

Anfragekörper

FeldArt

slugsListe von Text

Antwort

FeldArt

regionText Pflicht

region_selbst_gewaehltja/nein Pflicht

diensteListe von DienstOut Pflicht

meineListe von Text Pflicht

Aufbau der Antwort

{
  "region": "string",
  "region_selbst_gewaehlt": "boolean",
  "dienste": [
    {
      "slug": "string",
      "name": "string",
      "logo_url": "string | null"
    }
  ],
  "meine": [
    "string"
  ]
}

GET /api/studios may change

Known movie studios

A pick list of well-known studios. Only meaningful for movies.

Felder und Aufbau

Antwort

FeldArt

idZahl Pflicht

nameText Pflicht

Aufbau der Antwort

[
  {
    "id": "number",
    "name": "string"
  }
]

GET /api/watch may change

What you are waiting for

Titles marked as "tell me when this arrives".

Felder und Aufbau

Antwort

FeldArt

media_typeText Pflicht

tmdb_idZahl Pflicht

titleText Pflicht

poster_urlText oder null Pflicht

created_atText Pflicht

Aufbau der Antwort

[
  {
    "media_type": "string",
    "tmdb_id": "number",
    "title": "string",
    "poster_url": "string | null",
    "created_at": "string"
  }
]

DELETE /api/watch/{media_type}/{tmdb_id} may change

Stop waiting for a title

No 404 if nothing was marked: the goal is "stop telling me about this", and that is satisfied either way.

Felder und Aufbau

Parameter

media_typeText path Pflicht

tmdb_idZahl path Pflicht

Antwort

FeldArt

watchingja/nein Pflicht

Aufbau der Antwort

{
  "watching": "boolean"
}

PUT /api/watch/{media_type}/{tmdb_id} may change

Wait for a title

Clicking twice is a double click, not an error. Deliberately PUT and not POST: the call describes a state, not an event.

Felder und Aufbau

Parameter

media_typeText path Pflicht

tmdb_idZahl path Pflicht

Anfragekörper

FeldArt

titleText

poster_urlText oder null

Antwort

FeldArt

watchingja/nein Pflicht

Aufbau der Antwort

{
  "watching": "boolean"
}