Watchlog
wlog/1.0 application/wlog+json
프로그램과 영화를 원하는 곳으로 가져갈 수 있는 중립적이고 오래 가는 형식.
당신의 시청, 평점, 리뷰는 당신의 데이터입니다. Watchlog은 단순하고 읽기 쉬운, 문서화된 파일로, 이를 한 서비스에서 꺼내 다른 서비스에서 아무것도 잃지 않고 재현할 수 있게 합니다. 우리는 의도적으로 열린 형식으로 설계했습니다. 어떤 트래킹 앱이든 이를 쓰고 읽을 수 있습니다.
무엇이 이 형식을 똑똑하게 만드나
누구나 이해하는 id
모든 작품은 내부 번호가 아니라 외부 id(TMDB, IMDb, TheTVDB, 그리고 애니메이션의 경우 MyAnimeList / AniList / Kitsu)를 담습니다. 그래서 어떤 서비스든 올바른 프로그램이나 영화를 찾아낼 수 있습니다.
흐릿해도 진짜인 로그
시청은 날짜가 있는 목록입니다. 재시청은 그저 시청 한 번이 더해진 것이고, "봤지만 언제인지 기억나지 않아"는 날짜가 null입니다. 아무것도 지어내지 않고, 아무것도 잃지 않습니다.
척도를 유지하는 평점
평점은 값과 함께 척도도 담습니다. 5점 만점의 4점과 10점 만점의 8점이 왜곡 없이 공존합니다. 각 소비자가 나름의 방식으로 정규화합니다.
깨지지 않고 확장 가능
서비스별 풍부함(감정, 에피소드별 평점 등)은 해당 서비스 이름 아래의 `extensions` 공간에 담깁니다. 다른 리더는 이를 정중히 무시합니다. 핵심은 보편적으로 유지됩니다.
단순하고 깔끔하게 날짜가 붙은
평범한 JSON, 파일 상단에 버전 표시, ISO 8601(UTC) 날짜. 별난 도구가 필요 없고, 어떤 편집기에서도 열립니다.
어떻게 생겼나
헤더 객체(버전, 생성기, 프로필), 작품 목록, 리스트 목록. 다음은 핵심만 추린 한 항목입니다:
{
"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": []
}이 형식을 채택하려는 서비스를 위해
Watchlog은 자유롭게 사용할 수 있습니다. 구현에 필요한 모든 것이 여기 있습니다:
- 파일을 자동으로 검증하기 위한 JSON 스키마.
- 스키마로 주석이 달린 완전한 예시.
- Seenr은 참조 구현입니다. Watchlog을 내보내고 또 가져옵니다.
지금 바로 사용해 보세요
Seenr은 Watchlog을 유창하게 구사합니다. 라이브러리를 파일로 가져가거나, 여기서 하나를 재현해 보세요.
Watchlog은 재사용을 위해 공개된 열린 형식입니다. 미디어 타입은 아직 IANA에 등록되어 있지 않으며, 버전이 기준입니다.
