RuthFlix serie-API

Adresse og oppslag

GET https://www.ruthflix.no/api/public/series?q=The%20Diplomat
GET https://ruthflix.no/api/public/series?tmdb_id=203857
GET https://ruthflix.no/api/public/series?limit=20&offset=20

www-adressen videresendes til ruthflix.no. Bruk gjerne adressen uten www direkte. q søker i serietittelen (2–100 tegn). tmdb_id må være et positivt heltall. Begge filtre kan kombineres. Uten filtre returneres serier alfabetisk. limit er 1–20 (standard 20), offset er 0–10000 (standard 0).

Svar og score

JSON-svaret inneholder series, total, limit og offset. Hver serie har title, tmdb_id, description, genres, ruth_score, match_score, displayed_score, score_type, poster_url, alternative_poster_urls, still_image_urls, streaming_services, availability_updated_at, ruthflix_url og sources.

Ruth Score vises først. Bare når den mangler, returneres katalogens eksisterende, offentlige MatchScore. Ingen personlig score beregnes. score_type er ruth_score, match_score eller null. Manglende felt er null eller tomme lister. Et søk uten treff gir HTTP 200 med en tom series-liste.

Aktualitet, grenser og personvern

Bare publiserte serier og miniserier hentes fra RuthFlix-katalogen. Film, brukerkontoer, administratorinformasjon og skjulte titler inngår ikke. streaming_services inneholder katalogens norske tjenester, ikke VPN-tilgang. availability_updated_at viser siste lagrede kontroll, ikke en garanti for dagens tilgjengelighet.

Maksimalt 60 GET-forespørsler per 60 sekunder per offentlig IP-adresse. Delte nettverk deler grensen. IP-adressen lagres ikke; en hemmelig signert identifikator og en teller slettes ved senere forespørsler etter at de er utløpt. Uten tilgjengelig begrensning avvises oppslaget med HTTP 503. OPTIONS teller ikke. Svar er ikke mellomlagret, slik at grensen gjelder alle oppslag.

HTTP 400: ugyldige søkevalg. HTTP 405: kun GET og OPTIONS tillates. HTTP 429: for mange oppslag; vent antall sekunder i Retry-After. HTTP 503: midlertidig utilgjengelig. X-RateLimit-Limit og X-RateLimit-Remaining viser grensen og antall gjenværende oppslag. CORS tillater lesing fra alle nettsteder, uten innloggingsopplysninger.

Bilder og kildeopplysninger

Bare eksisterende plakat- og stillbildeadresser fra RuthFlix returneres. Flere plakater er foreløpig ikke lagret i katalogen, så alternative_poster_urls er tom. API-et henter ikke nye bilder hos TMDB. poster_url peker på eksisterende kildebilde, ikke et RuthFlix-kort med score eller bånd; bildet kan være levert i visningsstørrelse, ikke original full oppløsning.

This product uses the TMDB API but is not endorsed or certified by TMDB. Bilder tilhører sine respektive rettighetshavere. Tilgjengelige bildeadresser gir ikke automatisk tillatelse til bruk i Instagram, Reels eller annet markedsføringsinnhold. Kontroller nødvendige rettigheter før publisering. Kilder: RuthFlix kreditering og TMDBs bruksvilkår.