Tornevall Networks

← Back to docs

mcu-api

Language: SV | EN | SV

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

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:

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:

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:

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:

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:

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

Sortering

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

  1. mcutime - Kronologisk MCU-tidslinje
  2. premiere - Släppdatum
  3. season - Säsongsnummer (om tillämpligt)
  4. 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:

Hastighetsbegränsning

IMDB-integration

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

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

Felsökning

Inga resultat

Problem: Sökning eller filter returnerar tomma resultat.

Lösningar:

Hastighetsbegränsning överskreds

Problem: Får 429-fel.

Lösningar:

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:

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