shikimori-api 1.0.0

data/lib/shikimori/api/v1/users.rb

@@ -0,0 +1,310 @@
+# frozen_string_literal: true
+
+module Shikimori
+  module API
+    class V1
+      # Methods for the Users API
+      #
+      # @see https://shikimori.one/api/doc/1.0/users Shikimori's API documentation
+      module Users
+        # Get list of users
+        #
+        # @option headers [Hash] Request headers
+        # @option query [Hash] Query string parameters for request
+        # @option query [Integer] :page Number of page. Must be between 1 and 100000
+        # @option query [Integer] :limit Number of titles per page. Must be a lower or equal that 50
+        # @option query [String] :search Find user by name
+        #
+        # @return [Array<Hash>] Array of hashes representing users
+        #
+        # @see https://shikimori.one/api/doc/1.0/users/index Shikimori's API documentation
+        # @example Search users with by name "ivan"
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #
+        #   client.v1.users(search: 'ivan')
+        def users(headers: nil, **query)
+          rest.get base_url.join('users').url, headers: headers, query: query
+        end
+
+        # Get an user
+        #
+        # @option id [#to_s] User id
+        # @option headers [Hash] Request headers
+        # @option query [Hash] Query string parameters for request
+        #
+        # @return [Hash] Hash representing user
+        #
+        # @see https://shikimori.one/api/doc/1.0/users/show Shikimori's API documentation
+        # @example Get a user with id equal to 1
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #
+        #   client.v1.user(1)
+        def user(id, headers: nil, **query)
+          rest.get base_url.join('users', id.to_s).url, headers: headers, query: query
+        end
+
+        # Get an user's brief info
+        #
+        # @option id [#to_s] User id
+        # @option headers [Hash] Request headers
+        # @option query [Hash] Query string parameters for request
+        #
+        # @return [Hash] Hash representing user
+        #
+        # @see https://shikimori.one/api/doc/1.0/users/info Shikimori's API documentation
+        # @example Get a user info with id equal to 1
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   client.v1.user_info(1)
+        def user_info(id, headers: nil, **query)
+          rest.get base_url.join('users', id.to_s, 'info').url, headers: headers, query: query
+        end
+
+        # Get an current user's brief info
+        #
+        # @option headers [Hash] Request headers
+        # @option query [Hash] Query string parameters for request
+        #
+        # @return [Hash] Hash representing user
+        #
+        # @see https://shikimori.one/api/doc/1.0/users/whoami Shikimori's API documentation
+        # @example Get a current user info
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   client.v1.whoami
+        def whoami(headers: nil, **query)
+          rest.get base_url.join('users', 'whoami').url, headers: headers, query: query
+        end
+
+        # Sign out the user
+        #
+        # @option headers [Hash] Request headers
+        # @option query [Hash] Query string parameters for request
+        #
+        # @return [Hash] Hash representing user
+        #
+        # @see https://shikimori.one/api/doc/1.0/users/sign_out Shikimori's API documentation
+        # @example Sign out current user
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   client.v1.sign_out
+        def sign_out(headers: nil, **query)
+          rest.get base_url.join('users', 'sign_out').url, headers: headers, query: query
+        end
+
+        # Get an user's friends
+        #
+        # @option id [#to_s] User id
+        # @option headers [Hash] Request headers
+        # @option query [Hash] Query string parameters for request
+        #
+        # @return [Array<Hash>] Array of hashes representing user's friends
+        #
+        # @see https://shikimori.one/api/doc/1.0/users/friends Shikimori's API documentation
+        # @example
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   client.v1.user_friends(1)
+        def user_friends(id, headers: nil, **query)
+          rest.get base_url.join('users', id.to_s, 'friends').url, headers: headers, query: query
+        end
+
+        # Get an user's clubs
+        #
+        # @option id [#to_s] User id
+        # @option headers [Hash] Request headers
+        # @option query [Hash] Query string parameters for request
+        #
+        # @return [Array<Hash>] Array of hashes representing user's clubs
+        #
+        # @see https://shikimori.one/api/doc/1.0/users/clubs Shikimori's API documentation
+        # @example
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   client.v1.user_clubs(1)
+        def user_clubs(id, headers: nil, **query)
+          rest.get base_url.join('users', id.to_s, 'clubs').url, headers: headers, query: query
+        end
+
+        # Get an user's anime rates
+        #
+        # @option id [#to_s] User id
+        # @option headers [Hash] Request headers
+        # @option query [Hash] Query string parameters for request
+        # @option query [Integer] :page Number of page. Must be between 1 and 100000
+        # @option query [Integer] :limit Number of titles per page. Must be a lower or equal that 5000
+        # @option query [TrueClass, FalseClass] :censored Set to true to discard hentai, yaoi and yuri
+        # @option query ['planned', 'watching', 'rewatching', 'completed', 'on_hold', 'dropped'] :status Watching status
+        #
+        # @return [Array<Hash>] Array of hashes representing user's anime rates
+        #
+        # @see https://shikimori.one/api/doc/1.0/users/anime_rates Shikimori's API documentation
+        # @example
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   client.v1.user_anime_rates(1)
+        def user_anime_rates(id, headers: nil, **query)
+          rest.get base_url.join('users', id.to_s, 'anime_rates').url, headers: headers, query: query
+        end
+
+        # Get an user's manga rates
+        #
+        # @option id [#to_s] User id
+        # @option headers [Hash] Request headers
+        # @option query [Hash] Query string parameters for request
+        # @option query [Integer] :page Number of page. Must be between 1 and 100000
+        # @option query [Integer] :limit Number of titles per page. Must be a lower or equal that 5000
+        # @option query [TrueClass, FalseClass] :censored Set to true to discard hentai, yaoi and yuri
+        #
+        # @return [Array<Hash>] Array of hashes representing user's manga rates
+        #
+        # @see https://shikimori.one/api/doc/1.0/users/manga_rates Shikimori's API documentation
+        # @example
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   client.v1.user_manga_rates(1)
+        def user_manga_rates(id, headers: nil, **query)
+          rest.get base_url.join('users', id.to_s, 'manga_rates').url, headers: headers, query: query
+        end
+
+        # Get an user's favorites
+        #
+        # @option id [#to_s] User id
+        # @option headers [Hash] Request headers
+        # @option query [Hash] Query string parameters for request
+        #
+        # @return [Hash] Hash representing user's favorites
+        #
+        # @see https://shikimori.one/api/doc/1.0/users/favourites Shikimori's API documentation
+        # @example
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   client.v1.user_favorites(1)
+        def user_favorites(id, headers: nil, **query)
+          rest.get base_url.join('users', id.to_s, 'favourites').url, headers: headers, query: query
+        end
+
+        # Get an user's messages
+        # Requires `messages` oauth scope
+        #
+        # @option id [#to_s] User id
+        # @option headers [Hash] Request headers
+        # @option query [Hash] Query string parameters for request
+        # @option query [Integer] :page Number of page. Must be between 1 and 100000
+        # @option query [Integer] :limit Number of titles per page. Must be a lower or equal that 100
+        # @option query ['inbox', 'private', 'sent', 'news', 'notifications'] :type Type of messages
+        #
+        # @return [Array<Hash>] Array of hashes representing user's messages
+        #
+        # @see https://shikimori.one/api/doc/1.0/users/messages Shikimori's API documentation
+        # @example Get user's messages from inbox
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   client.v1.user_messages(1, type: 'inbox', limit: 10)
+        def user_messages(id, headers: nil, **query)
+          rest.get base_url.join('users', id.to_s, 'messages').url, headers: headers, query: query
+        end
+
+        # Get an user's unread messages
+        # Requires `messages` oauth scope
+        #
+        # @option id [#to_s] User id
+        # @option headers [Hash] Request headers
+        # @option query [Hash] Query string parameters for request
+        #
+        # @return [Hash] Hash representing user's messages
+        #
+        # @see https://shikimori.one/api/doc/1.0/users/unread_messages Shikimori's API documentation
+        # @example Get user's unread messages
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   client.v1.user_unread_messages(1, type: 'inbox', limit: 10)
+        def user_unread_messages(id, headers: nil, **query)
+          rest.get base_url.join('users', id.to_s, 'unread_messages').url, headers: headers, query: query
+        end
+
+        # Get an user's history
+        #
+        # @option id [#to_s] User id
+        # @option headers [Hash] Request headers
+        # @option query [Hash] Query string parameters for request
+        # @option query [Integer] :page Number of page. Must be between 1 and 100000
+        # @option query [Integer] :limit Number of titles per page. Must be a lower or equal that 100
+        # @option query [Integer] :target_id Target ID
+        # @option query ['Anime', 'Manga'] :target_type Target type
+        #
+        # @return [Array<Hash>] Array of hashes representing user's history
+        #
+        # @see https://shikimori.one/api/doc/1.0/users/history Shikimori's API documentation
+        # @example Get user's manga history
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   client.v1.user_history(1, type: 'manga', limit: 10)
+        def user_history(id, headers: nil, **query)
+          rest.get base_url.join('users', id.to_s, 'history').url, headers: headers, query: query
+        end
+
+        # Get an user's bans
+        #
+        # @option id [#to_s] User id
+        # @option headers [Hash] Request headers
+        # @option query [Hash] Query string parameters for request
+        #
+        # @return [Array<Hash>] Array of hashes representing user's bans
+        #
+        # @see https://shikimori.one/api/doc/1.0/users/bans Shikimori's API documentation
+        # @example Get user's manga bans
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   client.v1.user_bans
+        def user_bans(id, headers: nil, **query)
+          rest.get base_url.join('users', id.to_s, 'bans').url, headers: headers, query: query
+        end
+      end
+    end
+  end
+end

data/lib/shikimori/api/v1/videos.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Shikimori
+  module API
+    class V1
+      # Methods for the Videos API
+      #
+      # @see https://shikimori.one/api/doc/1.0/videos Shikimori's API documentation
+      module Videos
+        # Get anime videos
+        #
+        # @param anime_id [#to_s] Anime id
+        # @param headers [Hash] Request headers
+        # @param query [Hash] Query string parameters for request
+        #
+        # @return [Array<Hash>] Array of hashes representing videos
+        #
+        # @see https://shikimori.one/api/doc/1.0/videos/index Shikimori's API documentation
+        # @example Get videos for anime with id equal to 1
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   client.v1.anime_videos(1)
+        def anime_videos(anime_id, headers: nil, **query)
+          rest.get base_url.join('animes', anime_id.to_s, 'videos').url, headers: headers, query: query
+        end
+
+        # Create Video
+        #
+        # @param video [Hash] Video data for creating
+        # @option video [String] :name Name of video
+        # @option video ['pv', 'character_trailer', 'cm', 'op',
+        #   'ed', 'op_ed_clip', 'clip', 'other', 'episode_preview'] :kind Type of video
+        # @option video [String] :url URL to video.
+        #   Supported hostings: youtube, vk, ok, coub, rutube, vimeo, sibnet,
+        #   yandex, streamable, smotret_anime, myvi, youmite, viuly, stormo, mediafile
+        # @param headers [Hash] Request headers
+        # @param query [Hash] Query string parameters for request
+        #
+        # @return [Hash] Hash representing created video
+        #
+        # @see https://shikimori.one/api/doc/1.0/videos/create Shikimori's API documentation
+        # @example
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   video = { name: 'Funny cat!', kind: 'ed', url: 'https://youtu.be/dQw4w9WgXcQ' }
+        #   client.v1.create_anime_video(1, video)
+        def create_anime_video(anime_id, video, headers: nil, **query)
+          rest.post base_url.join('animes', anime_id.to_s, 'videos').url,
+                    { video: video },
+                    headers: headers, query: query
+        end
+
+        # Delete Video
+        #
+        # @param anime_id [#to_s] Anime id
+        # @param video_id [#to_s] Video id
+        # @param headers [Hash] Request headers
+        # @param query [Hash] Query string parameters for request
+        #
+        # @return [Boolean] True if deletion successful, false otherwise.
+        #
+        # @see https://shikimori.one/api/doc/1.0/videos/destroy Shikimori's API documentation
+        # @example
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #
+        #   client.v1.delete_anime_video(anime_id: 1, video_id: 1)
+        def delete_anime_video(anime_id:, video_id:, headers: nil, **query)
+          rest.delete base_url.join('animes', anime_id.to_s, 'videos', video_id.to_s).url,
+                      headers: headers,
+                      query: query
+        end
+      end
+    end
+  end
+end

data/lib/shikimori/api/v1.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require_relative 'v1/achievements'
+require_relative 'v1/animes'
+require_relative 'v1/appear'
+require_relative 'v1/bans'
+require_relative 'v1/calendars'
+require_relative 'v1/characters'
+require_relative 'v1/clubs'
+require_relative 'v1/comments'
+require_relative 'v1/constants'
+require_relative 'v1/dialogs'
+require_relative 'v1/favorites'
+require_relative 'v1/forums'
+require_relative 'v1/friends'
+require_relative 'v1/genres'
+require_relative 'v1/ignores'
+require_relative 'v1/mangas'
+require_relative 'v1/messages'
+require_relative 'v1/people'
+require_relative 'v1/publishers'
+require_relative 'v1/ranobe'
+require_relative 'v1/reviews'
+require_relative 'v1/stats'
+require_relative 'v1/studios'
+require_relative 'v1/styles'
+require_relative 'v1/topic_ignores'
+require_relative 'v1/topics'
+require_relative 'v1/user_images'
+require_relative 'v1/user_rates'
+require_relative 'v1/users'
+require_relative 'v1/videos'
+
+module Shikimori
+  module API
+    # Methods for first version of shikimori's API
+    class V1
+      include Achievements
+      include Animes
+      include Appear
+      include Bans
+      include Calendars
+      include Characters
+      include Clubs
+      include Comments
+      include Constants
+      include Dialogs
+      include Favorites
+      include Forums
+      include Friends
+      include Genres
+      include Ignores
+      include Mangas
+      include Messages
+      include People
+      include Publishers
+      include Ranobe
+      include Reviews
+      include Stats
+      include Studios
+      include Styles
+      include TopicIgnores
+      include Topics
+      include UserImages
+      include UserRates
+      include Users
+      include Videos
+
+      attr_reader :rest, :base_url
+
+      def initialize(base_url:, rest:)
+        @rest = rest
+        @base_url = base_url
+      end
+    end
+  end
+end

data/lib/shikimori/api/v2/abuse_requests.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module Shikimori
+  module API
+    class V2
+      # Methods for the Abuse requests API
+      #
+      # @see https://shikimori.one/api/doc/2.0/abuse_requests Shikimori's API documentation
+      module AbuseRequests
+        # Abuse offtopic request
+        #
+        # @param abuse_request [Hash] Abuse request data for creating
+        # @option abuse_request [Integer] :comment_id Comment id
+        # @param headers [Hash] Request headers
+        # @param query [Hash] Query string parameters for request
+        #
+        # @return [Hash] Hash representing abuse request
+        #
+        # @see https://shikimori.one/api/doc/2.0/abuse_requests/offtopic Shikimori's API documentation
+        # @example
+        #   client = Shikimori::API::Client.new(
+        #              app_name: 'Api Test',
+        #              aceess_token: '****',
+        #              refresh_token: '****'
+        #            )
+        #   client.v2.abuse_offtopic_request({ comment_id: 1, topic_id: 1, reason: 'Nani?!' })
+        def abuse_offtopic_request(abuse_request, headers: nil, **query)
+          rest.post base_url.join('abuse_requests', 'offtopic').url, abuse_request.to_h, headers: headers, query: query
+        end
+
+        # Abuse review request
+        #
+        # @param abuse_request [Hash] Abuse request data for creating
+        # @option abuse_request [Integer] :comment_id Comment id
+        # @option abuse_request [Integer] :topic_id Comment id
+        # @param headers [Hash] Request headers
+        # @param query [Hash] Query string parameters for request
+        #
+        # @return [Hash] Hash representing abuse request
+        #
+        # @see https://shikimori.one/api/doc/2.0/abuse_requests/convert_review Shikimori's API documentation
+        # @example
+        #   client = Shikimori::API::Client.new(
+        #              app_name: 'Api Test',
+        #              aceess_token: '****',
+        #              refresh_token: '****'
+        #            )
+        #   client.v2.abuse_review_request({ topic_id: 1 })
+        def abuse_review_request(abuse_request, headers: nil, **query)
+          rest.post base_url.join('abuse_requests', 'convert_review').url,
+                    abuse_request.to_h,
+                    headers: headers, query: query
+        end
+
+        # Abuse abuse request
+        #
+        # @param abuse_request [Hash] Abuse request data for creating
+        # @option abuse_request [Integer] :comment_id Comment id
+        # @option abuse_request [Integer] :topic_id Comment id
+        # @option abuse_request [String] :reason Reason to abuse
+        # @param headers [Hash] Request headers
+        # @param query [Hash] Query string parameters for request
+        #
+        # @return [Hash] Hash representing abuse request
+        #
+        # @see https://shikimori.one/api/doc/2.0/abuse_requests/abuse Shikimori's API documentation
+        # @example
+        #   client = Shikimori::API::Client.new(
+        #              app_name: 'Api Test',
+        #              aceess_token: '****',
+        #              refresh_token: '****'
+        #            )
+        #   client.v2.abuse_request({ topic_id: 1, reason: 'Nani?!' })
+        def abuse_request(abuse_request, headers: nil, **query)
+          rest.post base_url.join('abuse_requests', 'abuse').url, abuse_request.to_h, headers: headers, query: query
+        end
+
+        # Abuse spoiler request
+        #
+        # @param abuse_request [Hash] Abuse request data for creating
+        # @option abuse_request [Integer] :comment_id Comment id
+        # @option abuse_request [Integer] :topic_id Comment id
+        # @option abuse_request [String] :reason Reason to abuse
+        # @param headers [Hash] Request headers
+        # @param query [Hash] Query string parameters for request
+        #
+        # @return [Hash] Hash representing abuse request
+        #
+        # @see https://shikimori.one/api/doc/2.0/abuse_requests/spoiler Shikimori's API documentation
+        # @example
+        #   client = Shikimori::API::Client.new(
+        #              app_name: 'Api Test',
+        #              aceess_token: '****',
+        #              refresh_token: '****'
+        #            )
+        #   client.v2.abuse_spoiler_request({ comment_id: 1, reason: 'Nani?!' })
+        def abuse_spoiler_request(abuse_request, headers: nil, **query)
+          rest.post base_url.join('abuse_requests', 'spoiler').url, abuse_request.to_h, headers: headers, query: query
+        end
+      end
+    end
+  end
+end

data/lib/shikimori/api/v2/episode_notifications.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Shikimori
+  module API
+    class V2
+      # Methods for the Episode notifications API
+      #
+      # @see https://shikimori.one/api/doc/2.0/episode_notifications Shikimori's API documentation
+      module EpisodeNotifications
+        # Notify shikimori about anime episode release
+        #
+        # @param episode_notification [Hash] Episode notification data for creating
+        # @option episode_notification [Integer] :anime_id Anime id
+        # @option episode_notification [Integer] :episode Episode number
+        # @option episode_notification [String] :aired_at Date and time of aired
+        # @option episode_notification ['true', 'false', 1, 0] :is_fandub Is fandub?
+        # @option episode_notification ['true', 'false', 1, 0] :is_raw Is raw?
+        # @option episode_notification ['true', 'false', 1, 0] :is_subtitles Is with subtitles?
+        # @option episode_notification ['true', 'false', 1, 0] :is_anime365 Is Anime365?
+        # @param token [String] Private token required to access this api
+        # @param headers [Hash] Request headers
+        # @param query [Hash] Query string parameters for request
+        #
+        # @return [Hash] Hash representing created episode notification
+        #
+        # @see https://shikimori.one/api/doc/2.0/episode_notifications/create Shikimori's API documentation
+        # @example
+        #   client = Shikimori::API::Client.new(
+        #              app_name: 'Api Test',
+        #              aceess_token: '****',
+        #              refresh_token: '****'
+        #            )
+        #
+        #   notification = {
+        #     aired_at: "2022-11-19T17:19:31+03:00",
+        #     anime_id: "35",
+        #     episode: "3",
+        #     is_anime365: "true",
+        #     is_fandub: "true",
+        #     is_raw: "false",
+        #     is_subtitles: "false"
+        #    }
+        #   token = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+        #
+        #   client.v2.create_episode_notification(notification, token: token)
+        def create_episode_notification(episode_notification, token:, headers: nil, **query)
+          rest.post base_url.join('episode_notifications').url,
+                    { episode_notification: episode_notification, token: token },
+                    headers: headers, query: query
+        end
+      end
+    end
+  end
+end

data/lib/shikimori/api/v2/topic_ignore.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Shikimori
+  module API
+    class V2
+      # Methods for the Topic ignores API
+      #
+      # @see https://shikimori.one/api/doc/2.0/Topic%20Ignore Shikimori's API documentation
+      module TopicIgnore
+        # Add topic to ignore by id.
+        # Requires `topics` oauth scope
+        #
+        # @param topic_id [#to_s] Topic id
+        # @param headers [Hash] Request headers
+        # @param query [Hash] Query string parameters for request
+        #
+        # @return [Hash] Hash representing created topic ignore
+        #
+        # @see https://shikimori.one/api/doc/2.0/Topic%20Ignore/create Shikimori's API documentation
+        # @example Add to ignore a topic with id equal to 1
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   client.v2.create_topic_ignore(1)
+        def create_topic_ignore(topic_id, headers: nil, **query)
+          rest.post base_url.join('topics', topic_id.to_s, 'ignore').url, {}, headers: headers, query: query
+        end
+
+        # Delete a topic ignore by id.
+        # Requires `ignores` oauth scope
+        #
+        # @param topic_id [#to_s] Topic id
+        # @param headers [Hash] Request headers
+        # @param query [Hash] Query string parameters for request
+        #
+        # @return [Boolean] True if deletion successful, false otherwise.
+        #
+        # @see https://shikimori.one/api/doc/2.0/Topic%20Ignore/destroy Shikimori's API documentation
+        # @example Delete a topic ignore
+        #   client = Shikimori::API::Client.new(
+        #     app_name: 'Api Test',
+        #     aceess_token: '****',
+        #     refresh_token: '****'
+        #   )
+        #   client.v2.delete_topic_ignore(1)
+        def delete_topic_ignore(topic_id, headers: nil, **query)
+          rest.delete base_url.join('topics', topic_id.to_s, 'ignore').url, headers: headers, query: query
+        end
+      end
+    end
+  end
+end