rl404 / nagato

Unofficial MyAnimeList API library for Go

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Nagato

Go Report Card License: MIT Go Reference

nagato is just another API wrapper library to use MyAnimeList API.

This library contains 2 types of wrapper library, nagato and mal. mal is library to call MyAnimeList API without any validation and modification of the request and response. nagato wraps mal but will validate the request first before calling the API and modify the response to an easier to use format.

This libary is built following MyAnimeList's API reference and inspired by nstratos's library. This library also contains some undocumented documentation, so use it at your own risk.

Features

Feature mal nagato
Oauth2 ✔️ ✔️
Get anime list ✔️ ✔️
Get anime details ✔️ ✔️
Get anime ranking ✔️ ✔️
Get seasonal anime ✔️ ✔️
Get suggested anime ✔️ ✔️
Update my anime list ✔️ ✔️
Delete my anime list ✔️ ✔️
Get user anime list ✔️ ✔️
Get forum boards ✔️ ✔️
Get forum topic detail ✔️ ✔️
Get forum topics ✔️ ✔️
Get manga list ✔️ ✔️
Get manga details ✔️ ✔️
Get manga ranking ✔️ ✔️
Update my manga list ✔️ ✔️
Delete my manga list ✔️ ✔️
Get user manga list ✔️ ✔️
Get my user info ✔️ ✔️
Additional Features
Return response code ✔️ ✔️
Rate limit ✔️ ✔️
Validate request ✔️
Custom data type ✔️
Prettier returned struct ✔️

Installation

# For nagato.
go get github.com/rl404/nagato

# For mal.
go get github.com/rl404/nagato/mal

Requirement

You need client id and client secret to use the API. You can get them by registering from here.

Example

Please go to /example folder for examples. Also, you can read the documentation for more details.

Trivia

Nagato's name is taken from japanese battleship. She is the lead ship of the Nagato-class. Also, exists in Kantai Collection games and anime.

License

MIT License

Copyright (c) 2022 Axel

About

Unofficial MyAnimeList API library for Go

License:MIT License


Languages

Language:Go 100.0%