Changelog.md

29.10.2024 - Version 2.9.1

• Fix vulnerable System.Text.Json library reference to 8.0.5

29.10.2024 - Version 2.9.0

• Fix parsing entries metadata for HistoryEntry
• Remove no longer supported UserAnimeList and UserMangaList endpoints

02.10.2024 - Version 2.8.0

• Add new filters options for GetTopAnimeAsync and GetTopMangaAsync
• Fix vulnerability dependancy with System.Text.Json in netstandard2.0 package

17.11.2023 - Version 2.7.0

• Add support for .net 8

07.07.2023 - Version 2.6.1

• Features/Fixes
  • Adjust review models to new properties
    • Add IsSpoiler
    • Add ReviewReactions
    • Add Score (single integer)
    • Remove ReviewScores

04.04.2023 - Version 2.6.0

• Features
  • Add rate limiting

21.03.2023 - Version 2.5.1

• Fixes
  • Fix json deserialization of HttpCode returned from failed HTTP requests

24.01.2023 - Version 2.5.0

• Features
  • Add support of CancellationToken for all methods

07.01.2023 - Version 2.4.3

• Features
  • [TopAnime] Add optional filter (filter airing, upcoming, by popularity or by favorites)

18.11.2022 - Version 2.4.2

• Fixes
  • Fix assigning properties in JikanApiError
  • Remove obsolete ReportUrl from JikanApiError

14.11.2022 - Version 2.4.1

• Features
  • New Seasons endpoint
    • GetSeason(int page)
    • GetCurrentSeason()
    • GetCurrentSeason(int page)

02.11.2022 - Version 2.4.0

• Fixes
  • Generalize Pagination models from response causing deserialization errors for .net core 3.1 and older frameworks
    • PaginatedJikanResponse now contain properties CurrentPage and PaginationSummary from DbPaginatedJikanResponse
    • Every endpoint that was returning DbPaginatedJikanResponse is now returning PaginatedJikanResponse
    • Every endpoint that was returning PaginatedJikanResponse is still returning PaginatedJikanResponse but with null CurrentPage and PaginationSummary

23.10.2022 - Version 2.3.0

• Features
  • New endpoints
    • GetAnimeStreamingLinksAsync
    • GetUpcomingSeasonAsync with paging
    • GetProducerAsync
    • GetUserExternalLinksAsync
    • GetProducerExternalLinksAsync
    • GetUserExternalLinksAsync
    • GetUserUpdatesAsync
    • GetProducerFullDataAsync
  • [Anime/Manga]
    • Add Approved property
    • Add Titles collection property
    • Title, TitleEnglish, TitleJapanese and TitleSynonyms are now marked as obsolete
  • [AnimeVideos]
    • Add MusicVideos collection property
  • [AnimeCharacter]
    • Add Favorites property

24.06.2022 - Version 2.2.0

• Features
  • Add new endpoint for retrieving additional data in single call:
    • GetAnimeFullDataAsync
    • GetMangaFullDataAsync
    • GetCharacterFullDataAsync
    • GetPersonFullDataAsync
  • Add support for injecting own HTTP client with HttpClientFactory pattern
    • Passing custom endoint in configuration is still supported, but will be phased out

17.04.2022 - Version 2.1.1

• Fixes
  • [GetUserAnimeListAsync/GetUserMangaListAsync] - fix parsing watching_status and reading_status
• Features
  • Watching and reading statuses on user list endpoints are now represented in enum values UserAnimeWatchingStatus and UserMangaReadingStatus

14.04.2022 - Version 2.1.0

• Feature: additional paging information returned from entries queried from jikan database.

Example:

{
  "pagination": {
    "last_visible_page": 4, // already exists
    "has_next_page": true, // already exists
    
    // ...

    "current_page": 4, // NEW: as the name suggests, the current page we're on
    "items": { // NEW
      "count": 7, // results on the current page
      "total": 80, // total results
      "per_page": 25 // total results per page (can be changed with `limit` query)
    }
  },
  // data

This additional information is available in the following endpoints:

• Schedules
• Seasons
• Search Anime/Manga/People/Characters
• Top Anime/Manga/People/Characters

28.03.2022 - Version 2.0.1

• Bug fixes
  • [Character] Add missing NameKanji property
  • [AnimeSearchConfig/MangaSearchConfig] Adjust Genre, MagazineIds and ProducerIds according to recent changes

14.02.2022 - Version 2.0.0

• Compatible with Jikan REST API v4.0
  • Important - current documentation is for versions 1.x of library and is largely obsolete (although most of the endpoints overlaps). In the future, it will be either updated or moved to external documentation link. For now, please use the following guide.

16.09.2021 - Version 1.6.0

• Rework of Genres enumeration
  • GenreSearch enum is now change to two separate enums: AnimeGenreSearch and MangaGenreSearch.
  • [GetAnimeGenre] Now accepts AnimeGenreSearch as a parameter.
  • [GetMangaGenre] Now accepts MangaGenreSearch as a parameter.
  • [AnimeSearch] AnimeSearchConfig now has property Genres of AnimeGenreSearch type (was GenreSearch before).
  • [MangaSearch] MangaSearchConfig now has property Genres of MangaGenreSearch type (was GenreSearch before).

23.06.2021 - Version 1.5.6

• Features
  • [Validation] Validation of input parameters of Enum types parameters most method are added for fail fast approach.
• Fixes
  • [SearchManga] Remove redundant page part during url building.

01.04.2021 - Version 1.5.5

• Fixes
  • [Animelist|Mangalist] Fix building url for scenario with filter.

14.12.2020 - Version 1.5.4

• Fixes
  • [Seasons] Extends available range for acceptable input year to <1000, 9999>.

27.11.2020 - Version 1.5.3

• Jikan.net now can be used with own instance of HttpClient targetting Jikan REST API. Read more here.

26.10.2020 - Version 1.5.2

• Features
  • [Validation] Validation of input parameters for most method are added for fail fast approach. General rules
    • Methods using mal Id (e.g. GetAnime()) accept only number larger than 0.
    • Search query for searcg methods (e.g. SearchAnime()) must not be null or whitespace and at least 3 characters long.
    • Methods with page number as a parameter (e.g. SearchAnime()) only accepts page when it's larger than 0.
    • Search configs for search methods (e.g. SearchAnime()) must not null.

22.09.2020 - Version 1.5.1

• Fixes
  • [Character] Fix incorrect mapping for About property, which could led to null result.

10.09.2020 - Version 1.5.0

• Targetting multiple frameworks in order to decrease number of dependancies
  • System.Text.Json also is smaller library (30 KB vs Newtonsoft.Json's ~640 KB).
• Change from Newtonsoft.Json to System.Text.Json (bundled in basic library as for .NET Core 3.0)
  • No dependencies for .Net Core 3.0 and 3.1.
  • Single nuget dependancy (System.Text.Json) for .NET Standard 2.0 and compatible frameworks (.Net Core 2.0/2.1, .NET Framework 4.6.1 and newer).
• Fixes
  • [Manga/Anime] RelatedAnime/RelatedManga had some incorrect mappings, which could led to null collections.
  • Minor code cleanups.
• Changes
  • [Anime] Episodes are now int? instead of string.
  • [Manga] Chapters are now int? instead of string.
  • [Manga] Volumes are now int? instead of string.
  • [AnimeSubEntry] Episodes are now int? instead of string.
  • [MangasubEntry] Volumes are now int? instead of string.

08.07.2020 - Version 1.4.2

• Fixes
  • [MangaSearch/AnimeSearch] Fix incorrect url building for different GenreInclusion values in AnimeSearchConfig and MangaSearchConfig.

13.06.2020 - Version 1.4.1

• Fixes
  • [MangaSearch] Chapters property of MangaSearchEntry class changes to nullable (int?) due to occasional null returned.
  • Search Improved encoding queries with spaces (changed from underscore to plus sign).

31.05.2020 - Version 1.4.0

• Feature
  • suppressException is now turned off by default. This should give usert better insight on any exception occuring during call to Jikan API providing failed call code and/or exception message. User of wrapper can change it by passing true as a second parameter in the constructor - failed request will return nulls as before.
• Fixed feature
  • [AnimeSearch] Add SearchAnime(string query, int page AnimeSearchConfig searchConfig) method removed in version 1.3.3 after MAL fix it on their end.
  • [MangaSearch] Add SearchManga(string query, int page MangaSearchConfig searchConfig) method method removed in version 1.3.3 after MAL fix it on their end.

10.04.2020 - Version 1.3.3

• Fixes
  • [Search] Fix pagination.
• Fixes Features
  • [AnimeSearch] Remove SearchAnime(string query, int page AnimeSearchConfig searchConfig) method - MAL does not support pagination for search phrase with advanced filter.
  • [AnimeSearch] Add SearchAnime(AnimeSearchConfig searchConfig) and SearchAnime(AnimeSearchConfig searchConfig, int page) - it does support pagination for advanced filters without search phrase.
  • [MangaSearch] Remove SearchManga(string query, int page MangaSearchConfig searchConfig) method - MAL does not support pagination for search phrase with advanced filter.
  • [MangaSearch] Add SearchManga(MangaSearchConfig searchConfig) and SearchManga(MangaSearchConfig searchConfig, int page) - it does support pagination for advanced filters without search phrase.

20.11.2019 - Version 1.3.2

• Integration with Jikan API v3.4.
• Features
  • [User] UserId added to UserProfile

29.09.2019 - Version 1.3.1

• Fixes
  • [General] Removed null check during creation http client in order to avoid multiple Jikan objects holding same url.
  • [Search] Fixed incorrect parameters listing in search queries, which leaded to returning null.

31.07.2019 - Version 1.3.0

• Integration with Jikan API v3.3.
• Features
  • [Search] Improved searching for manga and anime
    • Order by data (Title, score, etc.)
    • Filter Producer (anime) or Magazine (manga)
    • Improved multiple genre query.
  • [UserList] Advanced User Lists (Anime/Manga) queries
    • Usable by passing UserListAnimeSearchConfig to GetUserAnimeList and UserListMangaSearchConfigto GetUserMangaList methods
      • Order by data: OrderBy, OrderBy2 (Title, score, etc.)
      • Sort by ascending/descending - SortBy
      • Search user list: Query property
      • New Anime filters: Producer, Season, Year, AiringStatus
      • New Manga filters: Magazine, PublishingStatus
      • Paging support: Page property
• Fixes
  • [AnimeEpisoded] changed Aired property from TimeSpan (a pair of DateTime) to single DateTime

07.04.2019 - Version 1.2.5

• Jikan.net now can be used with own instance of Jikan REST API. Read more here.
• New fields
  • RelatedAnime
    • RelatedAnime now has AlternativeVersions, ParentStories and FullStories fields.
  • RelatedManga
    • RelatedManga now has AlternativeVersions, ParentStories and FullStories fields.

17.03.2019 - Version 1.2.4

• Fixes
  • [Recommendation] Added missing Title field.
  • [AiringStatus] Fixed PlanToWatch/PlanToRead values (in 1.2.4).
• New fields
  • AnimeList
    • AnimeListEntry now has AiringStatus and PublishingStatus fields.
  • MangaList
    • MangaListEntry now has ReadingStatus and WatchingStatus fields.

06.01.2019 - Version 1.2.2

• Jikan class has parameterless contructor now, which makes requests over HTTPS by default.
• New class BaseJikanRequest with cache related properties is now inherited by all main classes returned from wrapper methods (search request only in version 1.2.2).

01.01.2019 - Version 1.2.0

• Integration with Jikan API v3.2.
• New endpoints
  • Anime
    • Reviews
    • Recommendations
    • User Updates
  • Manga
    • Reviews
    • Recommendations
    • User Updates
  • Season schedule with undefined date, marked as "Later" on MAL.
• Fixes
  • [Anime] Removed obsolete EpisodeNumber from AnimeEpisode class.
  • [Anime]/[Manga] Related field is deserialized properly when empty (fix in REST API).
• Other
  • All data from user related endpoints are now cached for 5 minutes only.
  • MAL entities with their own MAL Id now share IMalEntity interface.

23.11.2018 - Version 1.1.0

• Integration with Jikan API v3
• New endpoints
  • Genre
    • Anime genres
    • Manga genres
  • Producer
  • Magazine
  • User
    • Profile
    • Friends
    • History
      • Filter by Anime/Manga.
    • Anime list
      • Filter by status (watching, completed, etc.)
      • Paging support
    • Manga list
      • Filter by status (reading, completed, etc.)
      • Paging support
  • Meta
    • API status
  • Top
    • People Top.
    • Characters Top.
  • Season Archive
• Extensions are no longer supported due to changes in REST API. Each type of extension now has separate method. Example:
  • Previously:
    • GetAnime(id) -> returns basic information about anime.
    • GetAnime(id, AnimeExtension.CharactersStaff) -> return basic information and characters/staff.
  • Currently:
    • GetAnime(id) -> returns basic information about anime.
    • GetAnimeCharactersStaff(id) -> return characters/staff of anime.
• [Search] Status enum renamed to AiringStatus
• [Anime]
  • Removed AiredString
  • Pictures is now collection of Picture type.
  • StaffPositionEntry.Role is now a collection.
  • ForumPostSnippet.DateRelatice is now DateTime.
• [Manga]
  • Removed PublishedString
  • TitleSynonyms are now a collection.
  • Pictures is now collection of Picture type.
  • Authors, Genres and Serializations are now MALSubItem collections.
• [Character]
  • Nicknames are now a collection.
  • Images got renamed to Pictures and now are collection of Picture type.
• [Person]
  • Birthday is now DateTime.
  • Images got renamed to Pictures and now are collection of Picture type.
• [AnimeSearch]
  • Add Airing, StartDate, EndDate and Rated data.
• [MangaSearch]
  • Add Publishing, StartDate, EndDate and Chapters data.
• [CharactersSearch]
  • Nicknames are now a collection.
• [PersonSearch]
  • Nicknames got renamed to AlternativeNames and are now a collection.
• [Schedule]
  • Filtering by day of the week is enabled now.

27.05.2018 - Version 1.0.3

• [Season] Add SeasonName and SeasonYear data.

20.05.2018 - Version 1.0.2

• [Character|Person] Added add role info in animeography and mangaography (Character) and voice acting roles (Person).
• [Season] Added "type" and "continued" properties for season entry.

15.05.2018 - Version 1.0.1

• Fixed issue #1 - error during parsing anime/manga with no related entries.

14.05.2018 - Version 1.0.0

• Requests for searching on MyAnimeList
• More overload methods.
• Initial version, up to date with Jikan API.

08.05.2018 - Version 0.3.0

• Request for season preview.
• Request for anime schedule of current season.
• Request for Top Manga & Anime.

05.05.2018 - Version 0.2.0

• Extended request for Anime/Manga/Character/Person via extensions.

02.05.2018 - Version 0.1.0

• First usable version.
• Added basic requests for Anime/Manga/Person/Character.