Watchlog

wlog/1.0 application/wlog+json

Neutralny, trwały format, dzięki któremu zabierzesz swoje seriale i filmy tam, gdzie chcesz.

Twoje seanse, Twoje oceny, Twoje recenzje: to Twoje dane. Watchlog to prosty, czytelny i udokumentowany plik, który pozwala wyeksportować je z jednego serwisu i odtworzyć w innym, nie tracąc niczego po drodze. Zaprojektowaliśmy go tak, by z założenia był otwarty: każda aplikacja śledząca może go zapisywać i odczytywać.

Eksportuj jako Watchlog Specyfikacja

Co czyni go sprytnym

Identyfikatory, które wszyscy rozumieją

Każdy tytuł niesie swoje zewnętrzne identyfikatory (TMDB, IMDb, TheTVDB, a dla anime dodatkowo MyAnimeList / AniList / Kitsu), nigdy numer wewnętrzny. Dzięki temu każdy serwis potrafi trafić na właściwy serial lub film.

Prawdziwy dziennik, nawet niepewny

Seanse to datowana lista. Ponowne obejrzenie to po prostu kolejny wpis; „obejrzałem, ale nie pamiętam kiedy” to pusta data. Nic nie jest zmyślane, nic nie ginie.

Oceny, które zachowują swoją skalę

Ocena niesie swoją wartość ORAZ swoją skalę: 4 na 5 i 8 na 10 współistnieją bez zniekształceń. Każdy odbiorca normalizuje je po swojemu.

Rozszerzalny bez łamania zgodności

Bogactwo specyficzne dla danego serwisu (emocje, oceny poszczególnych odcinków…) mieszka w przestrzeni `extensions` pod nazwą tego serwisu. Inny czytnik grzecznie je pomija: rdzeń pozostaje uniwersalny.

Prosty, schludnie datowany

Zwykły JSON, z wersją na początku pliku, z datami ISO 8601 (UTC). Żadnych egzotycznych narzędzi, otwiera się w dowolnym edytorze.

Jak to wygląda

Obiekt nagłówka (wersja, generator, profil), lista tytułów, lista list. Oto jeden element sprowadzony do tego, co najważniejsze:

{
  "format": "wlog/1.0",
  "generator": { "name": "Seenr", "url": "https://seenr.app" },
  "profile": { "handle": "kevin", "locale": "fr" },
  "items": [
    {
      "type": "show",
      "ids": { "tmdb": 1429, "imdb": "tt1355642", "mal": 5114, "anilist": 5114 },
      "title": "Fullmetal Alchemist: Brotherhood",
      "year": 2009,
      "status": "completed",
      "favorite": true,
      "tags": ["anime", "shonen"],
      "rating": { "value": 10, "scale": 10, "rated_at": "2021-02-01T20:00:00Z" },
      "watches": [
        { "season": 1, "episode": 1, "watched_at": "2021-01-05T21:00:00Z" }
      ],
      "season_ratings":  [ { "season": 1, "value": 9,  "scale": 10 } ],
      "episode_ratings": [ { "season": 1, "episode": 5, "value": 10, "scale": 10 } ],
      "extensions": { "seenr": { "emotions": ["😭"] } }
    }
  ],
  "lists": []
}

Specyfikacja

Wersja: wlog/1.0
Typ multimediów: application/wlog+json

Schemat JSON schema.json › Przykład example.json › Kod źródłowy GitHub ›

Dla serwisów, które chcą go przyjąć

Watchlog można używać za darmo. Wszystko, czego potrzebujesz do jego wdrożenia, jest tutaj:

Schemat JSON, do automatycznej walidacji pliku.
Kompletny przykład, opatrzony adnotacjami schematu.
Seenr to implementacja referencyjna: eksportuje ORAZ importuje Watchlog.

Wypróbuj od razu

Seenr biegle mówi w Watchlog. Pobierz swoją bibliotekę jako plik albo odtwórz jeden tutaj.

Eksportuj jako Watchlog Importuj plik Watchlog

Watchlog to otwarty format, opublikowany po to, by go ponownie wykorzystywać. Typ multimediów nie jest jeszcze zarejestrowany w IANA; wersja jest autorytatywna.