Marvel MCU Timeline API - Användarguide

Översikt

Marvel MCU Timeline API ger tillgång till en omfattande kronologisk databas över allt Marvel Cinematic Universe-innehåll, inklusive filmer, TV-serier, one-shots och webbserier.

Bas-URL: https://tools.tornevall.net/api/mcu

Hastighetsbegränsning: 9000 förfrågningar per minut

Nyckelfunktioner

Komplett MCU-tidslinje - Alla filmer, serier och kortfilmer i kronologisk ordning
Fasorganisation - Innehåll grupperat efter MCU-faser
Kategorier - Filmer, TV-serier, one-shots, webbserier
Samlingar - Grupperat innehåll (t.ex. Infinity Saga, Multiverse Saga)
IMDB-integration - Automatisk IMDB-databerikning
RSS-feed - Prenumerera på tidslinjeuppdateringar
Sök - Hitta innehåll efter titel, nyckelord eller IMDB-ID

Snabbstart

Hämta fullständig tidslinje

curl "https://tools.tornevall.net/api/mcu/timeline"

Returnerar allt MCU-innehåll i kronologisk ordning, grupperat efter kategori (Filmer, TV-serier, etc.).

Hämta specifik fas

# Fas 4
curl "https://tools.tornevall.net/api/mcu/phase/4"

# Flera faser
curl "https://tools.tornevall.net/api/mcu/phase/4,5"

Sök efter innehåll

# Hitta allt Spider-Man-innehåll
curl "https://tools.tornevall.net/api/mcu/find/spider-man"

# Sök efter skådespelare
curl "https://tools.tornevall.net/api/mcu/find/robert+downey"

API-endpoints

Tidslinjeendpoints

Hämta fullständig tidslinje

Endpoint: /api/mcu/timeline
Metod: GET
Alias: /api/mcu/

Returnerar den kompletta MCU-tidslinjen organiserad efter kategorier.

Exempel:

curl "https://tools.tornevall.net/api/mcu/timeline"

Svar:

{
  "mcuTimeLine": {
    "Movies": [
      {
        "mcuid": 1,
        "title": "Captain America: The First Avenger",
        "premiere": "2011-07-22",
        "mcutime": "1942-1945",
        "category": "Movies",
        "phase": 1,
        "imdb": "https://www.imdb.com/title/tt0458339/",
        "distribution": "Theatrical Release",
        "ourSortOrder": ["mcutime", "premiere", "season", "episode"]
      }
    ],
    "TV Shows": [...],
    "One-Shots": [...]
  }
}

Hämta tidslinje efter kategori

Endpoint: /api/mcu/timeline/category/{categoryId}
Metod: GET

Hämta innehåll från en specifik kategori.

Kategori-ID:n:

1 = Filmer
2 = TV-serier
3 = One-Shots
4 = Webbserier

Exempel:

# Hämta endast filmer
curl "https://tools.tornevall.net/api/mcu/timeline/category/1"

Hämta innehåll efter fas

Endpoint: /api/mcu/phase/{phaseNumber}
Metod: GET

Filtrera innehåll efter MCU-fas(er).

Faser:

Fas 1: Iron Man till Avengers (2008-2012)
Fas 2: Iron Man 3 till Ant-Man (2013-2015)
Fas 3: Civil War till Far From Home (2016-2019)
Fas 4: WandaVision till The Marvels (2021-2023)
Fas 5: Secret Invasion och framåt (2023+)

Exempel:

# Hämta Fas 4-innehåll
curl "https://tools.tornevall.net/api/mcu/phase/4"

# Hämta flera faser
curl "https://tools.tornevall.net/api/mcu/phase/3,4,5"

Hämta innehåll efter samling

Endpoint: /api/mcu/collection/{collectionId}
Metod: GET

Filtrera efter samling (saga-gruppering).

Exempel:

# Hämta Infinity Saga
curl "https://tools.tornevall.net/api/mcu/collection/1"

# Hämta Multiverse Saga
curl "https://tools.tornevall.net/api/mcu/collection/2"

För att se tillgängliga samlingar:

curl "https://tools.tornevall.net/api/mcu/collections"

Upptäcktsendpoints

Hämta senaste innehåll

Endpoint: /api/mcu/latest
Metod: GET

Returnerar det senast tillagda innehållet i databasen.

Exempel:

curl "https://tools.tornevall.net/api/mcu/latest"

Hämta aktuellt innehåll

Endpoint: /api/mcu/current
Metod: GET
Alias: /api/mcu/last

Returnerar innehåll som för närvarande sänds eller senast släpptes.

Exempel:

curl "https://tools.tornevall.net/api/mcu/current"

Hämta nästa/kommande innehåll

Endpoint: /api/mcu/next
Metod: GET
Alias: /api/mcu/coming

Returnerar kommande MCU-releaser.

Exempel:

curl "https://tools.tornevall.net/api/mcu/next"

Sök & Filter

Fritextsök

Endpoint: /api/mcu/find/{searchTerm}
Metod: GET

Sök över titlar, nyckelord, IMDB-ID:n och beskrivningar.

Sökbara fält:

Titel
Premiärdatum
MCU-tidslinjeplacering
IMDB-ID
Distributionsmetod
Innehållsinformation
Kategori
Nyckelord

Exempel:

# Sök efter titel
curl "https://tools.tornevall.net/api/mcu/find/avengers"

# Sök efter skådespelare
curl "https://tools.tornevall.net/api/mcu/find/chris+evans"

# Sök efter år
curl "https://tools.tornevall.net/api/mcu/find/2023"

# Sök efter nyckelord
curl "https://tools.tornevall.net/api/mcu/find/multiverse"

Filtrera efter distributör

Query-parameter: ?distributor= eller ?distribution=

Filtrera innehåll efter distributionsmetod.

Vanliga distributörer:

Theatrical Release
Disney+
Netflix
ABC
Hulu

Exempel:

# Hämta endast Disney+-serier
curl "https://tools.tornevall.net/api/mcu/timeline?distributor=Disney%2B"

# Hämta biografsläpp
curl "https://tools.tornevall.net/api/mcu/timeline?distribution=Theatrical+Release"

Metadata-endpoints

Hämta kategorier

Endpoint: /api/mcu/categories
Metod: GET

Returnerar lista över alla innehållskategorier.

Exempel:

curl "https://tools.tornevall.net/api/mcu/categories"

Svar:

[
  {
    "cid": 1,
    "category": "Movies",
    "phase": 0
  },
  {
    "cid": 2,
    "category": "TV Shows",
    "phase": 0
  }
]

Hämta samlingar

Endpoint: /api/mcu/collections
Metod: GET

Returnerar lista över alla samlingar (sagor).

Exempel:

curl "https://tools.tornevall.net/api/mcu/collections"

Svar:

[
  {
    "collectionid": 1,
    "collectionName": "The Infinity Saga"
  },
  {
    "collectionid": 2,
    "collectionName": "The Multiverse Saga"
  }
]

RSS-feed

Endpoint: /api/mcu/timeline?get=rss
Metod: GET

Hämta tidslinjeuppdateringar som en RSS/Atom-feed.

Exempel:

curl "https://tools.tornevall.net/api/mcu/timeline?get=rss"

Användningsfall:

Prenumerera i RSS-läsare
Få notiser om nya tillägg
Spåra tidslinjeuppdateringar
Övervaka kommande releaser

Feed-URL för RSS-läsare:

https://tools.tornevall.net/api/mcu/timeline?get=rss

Svarsformat

Standardpost

Varje innehållspost inkluderar:

{
  "mcuid": 123,
  "title": "Innehållstitel",
  "premiere": "2023-11-10",
  "premiereUnix": 1699574400,
  "mcutime": "2024",
  "season": null,
  "episode": null,
  "category": "Movies",
  "phase": 5,
  "imdb": "https://www.imdb.com/title/tt1234567/",
  "distribution": "Theatrical Release",
  "collectionName": "The Multiverse Saga",
  "contentinformation": {
    "runtime": "120 min",
    "directors": ["Regissörens namn"],
    "writers": ["Manusforfatterens namn"]
  },
  "imdbcache": {
    "rating": "8.5",
    "genres": ["Action", "Adventure"],
    "cast": [
      {"name": "Skådespelarens namn", "character": "Karaktärens namn"}
    ]
  },
  "links": {
    "disney": "https://www.disneyplus.com/...",
    "trailer": "https://www.youtube.com/..."
  },
  "keywords": "keyword1, keyword2",
  "ourSortOrder": ["mcutime", "premiere", "season", "episode"]
}

Fältbeskrivningar

mcuid - Unik identifierare
title - Officiell titel
premiere - Släpp-/sändningsdatum (ÅÅÅÅ-MM-DD)
premiereUnix - Unix-tidsstämpel för premiär
mcutime - När det utspelar sig i MCU-kronologin
season - Säsongsnummer (för TV-serier)
episode - Avsnittsnummer (för TV-serier)
category - Filmer, TV-serier, One-Shots, Webbserier
phase - MCU-fasnummer
imdb - IMDB-URL
distribution - Hur det släpptes/distribuerades
collectionName - Saga-/samlingsnamn
contentinformation - Ytterligare metadata (JSON)
imdbcache - Cachad IMDB-data (JSON)
links - Externa länkar (JSON)
keywords - Sökbara nyckelord
ourSortOrder - Rekommenderad sorteringsordning

Sortering

Resultat sorteras efter ourSortOrder-fältet, som vanligtvis är:

mcutime - Kronologisk MCU-tidslinje
premiere - Släppdatum
season - Säsongsnummer (om tillämpligt)
episode - Avsnittsnummer (om tillämpligt)

Detta säkerställer att innehållet visas i den ordning det bör ses för kronologisk visning.

Vanliga användningsfall

Bygg en watchlist-app

// Hämta allt MCU-innehåll
fetch('https://tools.tornevall.net/api/mcu/timeline')
  .then(r => r.json())
  .then(data => {
    const movies = data.mcuTimeLine.Movies;
    const shows = data.mcuTimeLine['TV Shows'];
    
    // Visa kronologiskt
    movies.forEach(movie => {
      console.log(movie.title, movie.mcutime);
    });
  });

Kolla vad som kommer härnäst

fetch('https://tools.tornevall.net/api/mcu/next')
  .then(r => r.json())
  .then(data => {
    console.log('Kommer snart:', data.mcuTimeLine);
  });

Fas-för-fas-visare

async function getPhase(phaseNum) {
  const response = await fetch(
    `https://tools.tornevall.net/api/mcu/phase/${phaseNum}`
  );
  const data = await response.json();
  return data.mcuTimeLine;
}

// Hämta Fas 4
const phase4 = await getPhase(4);

Sök och filtrera

// Hitta allt Spider-Man-innehåll
fetch('https://tools.tornevall.net/api/mcu/find/spider-man')
  .then(r => r.json())
  .then(data => {
    console.log('Spider-Man-innehåll:', data.mcuTimeLine);
  });

// Hämta endast Disney+-innehåll
fetch('https://tools.tornevall.net/api/mcu/timeline?distributor=Disney%2B')
  .then(r => r.json())
  .then(data => {
    console.log('Disney+-serier:', data.mcuTimeLine);
  });

Webbgränssnitt

Visa MCU-tidslinjen i ett webbgränssnitt:

URL: https://tools.tornevall.net/mcu

Funktioner:

Visuell tidslinje
Fasfiltrering
Kategorigruppering
Sökfunktionalitet
Direktlänkar till IMDB

Hastighetsbegränsning

Gräns: 9000 förfrågningar per minut
Tillräckligt för: De flesta applikationer inklusive realtidsappar
Bästa praxis: Cachea svar när det är möjligt

IMDB-integration

API:et berikar automatiskt innehåll med IMDB-data inklusive:

Betyg
Skådespelarinformation
Genreklassificeringar
Handlingssammanfattningar
Speltidinformation

IMDB-data cachas för att förbättra prestanda.

Felsökning

Inga resultat

Problem: Sökning eller filter returnerar tomma resultat.

Lösningar:

Kontrollera stavning i söktermer
Prova bredare söktermer
Verifiera att fas-/kategori-ID:n är korrekta
Använd /categories eller /collections för att se giltiga ID:n

Hastighetsbegränsning överskreds

Problem: Får 429-fel.

Lösningar:

Implementera cachelagring på klientsidan
Minska förfrågningsfrekvensen
Batchförfrågningar där det är möjligt
Gränsen är mycket hög (9000/min), så detta är sällsynt

Saknad IMDB-data

Problem: imdbcache-fältet är tomt eller null.

Lösning: IMDB-data hämtas och cachas automatiskt. Om den saknas kanske den inte är tillgänglig än. Försök igen senare eller så kanske innehållet inte har en IMDB-sida.

Tips & bästa praxis

Kronologisk visningsordning

Använd standardsorteringsordningen:

curl "https://tools.tornevall.net/api/mcu/timeline"

Resultat är försorterade i kronologisk MCU-ordning.

Släppdatumsordning

Sortera efter premiere-fält om du vill ha släppordning istället för kronologisk ordning.

Filtrera flera kriterier

Kombinera fas och distributör:

curl "https://tools.tornevall.net/api/mcu/phase/4?distributor=Disney%2B"

Prenumerera på uppdateringar

Använd RSS-feeden i din favorit-RSS-läsare:

https://tools.tornevall.net/api/mcu/timeline?get=rss

Exempel: Kompletta MCU Fas 4 Disney+-serier

curl "https://tools.tornevall.net/api/mcu/phase/4?distributor=Disney%2B" | jq

Returnerar allt Fas 4 Disney+-innehåll i kronologisk ordning.

Support

För problem eller frågor:

Kolla denna dokumentation
Besök webbgränssnittet: https://tools.tornevall.net/mcu
Granska Atlassian-dokumentation
Kontakta systemadministratören

Senast uppdaterad: 2026-02-09
API-version: 1.0
Datakälla: Marvel Cinematic Universe officiell tidslinje

Tornevall Networks