Added XML comments
This commit is contained in:
Alexander Rufenach
@@ -12,15 +12,31 @@ using Jellyfin.Plugin.AnilistSync.API.Exceptions;
|
||||
|
||||
namespace Jellyfin.Plugin.AnilistSync.API
|
||||
{
|
||||
/// <summary>
|
||||
/// Anilist API.
|
||||
/// </summary>
|
||||
public class AnilistApi
|
||||
{
|
||||
// Interfaces //
|
||||
private readonly ILogger<AnilistApi> _logger;
|
||||
private readonly IHttpClientFactory _httpClientFactory;
|
||||
private readonly JsonSerializerOptions _jsonSerializerOptions;
|
||||
|
||||
// Base URLs //
|
||||
|
||||
/// <summary>
|
||||
/// Base url for OAUth uses.
|
||||
/// </summary>
|
||||
public const string BaseOauthUrl = @"https://anilist.co/api/v2";
|
||||
|
||||
/// <summary>
|
||||
/// Base url for GraphQL queries.
|
||||
/// </summary>
|
||||
public const string GraphQLUrl = @"https://graphql.anilist.co";
|
||||
|
||||
/// <summary>
|
||||
/// Generic GraphQL query string used for list updates.
|
||||
/// </summary>
|
||||
public const string QueryString = @"
|
||||
mutation ($id: Int, $mediaId: Int, $status: MediaListStatus, $progress: Int,) {
|
||||
SaveMediaListEntry(id: $id, mediaId: $mediaId, status: $status, progress: $progress ) {
|
||||
@@ -30,10 +46,21 @@ mutation ($id: Int, $mediaId: Int, $status: MediaListStatus, $progress: Int,) {
|
||||
progress
|
||||
}
|
||||
}";
|
||||
|
||||
/// <summary>
|
||||
/// Anilist client ID.
|
||||
/// </summary>
|
||||
public const int ClientId = 5659;
|
||||
|
||||
/// <summary>
|
||||
/// Secret.
|
||||
/// </summary>
|
||||
public const string Secret = @"h7ym2GZ6OjrdJ9sygDP7kDnQWsBdTwp4U8s7pt4X";
|
||||
|
||||
/// <summary>
|
||||
/// Initializes a new instance of <see cref="AnilistApi"/> class.
|
||||
/// </summary>
|
||||
/// <param name="logger">Instance of the <see cref="ILogger{AnilistApi}"/> interface.</param>
|
||||
/// <param name="httpClientFactory">Instance of the <see cref="IHttpClientFactory"/> interface.</param>
|
||||
public AnilistApi(ILogger<AnilistApi> logger, IHttpClientFactory httpClientFactory)
|
||||
{
|
||||
_logger = logger;
|
||||
@@ -41,7 +68,11 @@ mutation ($id: Int, $mediaId: Int, $status: MediaListStatus, $progress: Int,) {
|
||||
_jsonSerializerOptions = JsonDefaults.GetOptions();
|
||||
}
|
||||
|
||||
|
||||
/// <summary>
|
||||
/// Get token.
|
||||
/// </summary>
|
||||
/// <param name="code">code.</param>
|
||||
/// <returns><see cref="CodeResponse"/></returns>
|
||||
public async Task<CodeResponse?> GetToken(string? code)
|
||||
{
|
||||
string uri = @"/oauth/token";
|
||||
@@ -58,6 +89,11 @@ mutation ($id: Int, $mediaId: Int, $status: MediaListStatus, $progress: Int,) {
|
||||
return await responseMessage.Content.ReadFromJsonAsync<CodeResponse>(_jsonSerializerOptions);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Gets total episodes of specified Anilist mediaID.
|
||||
/// </summary>
|
||||
/// <param name="anilistId">Anilist ID.</param>
|
||||
/// <returns><see cref="RootObject"/> containing total episodes parameter.</returns>
|
||||
public async Task<RootObject?> GetEpisodes(int? anilistId)
|
||||
{
|
||||
GraphQLBody content = new GraphQLBody {
|
||||
@@ -73,6 +109,11 @@ mutation ($id: Int, $mediaId: Int, $status: MediaListStatus, $progress: Int,) {
|
||||
return await Post(content);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Gets the name and ID of the currently authenticated user.
|
||||
/// </summary>
|
||||
/// <param name="userToken">User token.</param>
|
||||
/// <returns><see cref="RootObject"/>containing <see cref="User"/> object.</returns>
|
||||
public async Task<RootObject?> GetUser(string? userToken)
|
||||
{
|
||||
GraphQLBody content = new GraphQLBody {
|
||||
@@ -82,6 +123,12 @@ mutation ($id: Int, $mediaId: Int, $status: MediaListStatus, $progress: Int,) {
|
||||
return await PostWithAuth(userToken, content);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Gets user's list ID of specified Anilist mediaID
|
||||
/// </summary>
|
||||
/// <param name="userToken">User token.</param>
|
||||
/// <param name="anilistId">Anilist mediaID</param>
|
||||
/// <returns><see cref="RootObject"/> containing <see cref="ListEntry"/></returns>
|
||||
public async Task<RootObject?> GetListEntry(string? userToken, int? anilistId)
|
||||
{
|
||||
GraphQLBody content = new GraphQLBody
|
||||
@@ -98,6 +145,13 @@ mutation ($id: Int, $mediaId: Int, $status: MediaListStatus, $progress: Int,) {
|
||||
return await PostWithAuth(userToken, content);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Updates status of specified list item
|
||||
/// </summary>
|
||||
/// <param name="userToken">User token.</param>
|
||||
/// <param name="listId">List ID</param>
|
||||
/// <param name="status">Status.</param>
|
||||
/// <returns><see cref="RootObject"/> containing updated list item.</returns>
|
||||
public async Task<RootObject?> PostListStatusUpdate(string? userToken, int? listId, MediaListStatus? status)
|
||||
{
|
||||
GraphQLBody content = new GraphQLBody
|
||||
@@ -114,6 +168,13 @@ mutation ($id: Int, $mediaId: Int, $status: MediaListStatus, $progress: Int,) {
|
||||
return await PostWithAuth(userToken, content);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Updates progress of specified list item.
|
||||
/// </summary>
|
||||
/// <param name="userToken">User token.</param>
|
||||
/// <param name="listId">List ID></param>
|
||||
/// <param name="progress">Progress.</param>
|
||||
/// <returns><see cref="RootObject"/> containing updated list item.</returns>
|
||||
public async Task<RootObject?> PostListProgressUpdate(string? userToken, int? listId, int? progress)
|
||||
{
|
||||
GraphQLBody content = new GraphQLBody
|
||||
@@ -130,6 +191,11 @@ mutation ($id: Int, $mediaId: Int, $status: MediaListStatus, $progress: Int,) {
|
||||
return await PostWithAuth(userToken, content);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// API private GraphQL Post WITHOUT authentication.
|
||||
/// </summary>
|
||||
/// <param name="graphQL"><see cref="GraphQLBody"/> containing query and variables</param>
|
||||
/// <returns><see cref="RootObject"/> containing API response.</returns>
|
||||
public async Task<RootObject?> Post(GraphQLBody graphQL)
|
||||
{
|
||||
var responseMessage = await _httpClientFactory.CreateClient(NamedClient.Default).PostAsJsonAsync<GraphQLBody>(GraphQLUrl, graphQL, _jsonSerializerOptions);
|
||||
@@ -144,6 +210,12 @@ mutation ($id: Int, $mediaId: Int, $status: MediaListStatus, $progress: Int,) {
|
||||
return root;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// API private GraphQL Post WITH authentication.
|
||||
/// </summary>
|
||||
/// <param name="userToken">User token.</param>
|
||||
/// <param name="graphQL"><see cref="GraphQLBody"/> containing query and variables</param>
|
||||
/// <returns><see cref="RootObject"/> containing API response.</returns>
|
||||
public async Task<RootObject?> PostWithAuth(string? userToken, GraphQLBody graphQL)
|
||||
{
|
||||
using var requestMessage = new HttpRequestMessage
|
||||
|
||||
Reference in New Issue
Block a user