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.
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 | ❌ | ✔️ |
# For nagato.
go get github.com/rl404/nagato
# For mal.
go get github.com/rl404/nagato/mal
You need client id and client secret to use the API. You can get them by registering from here.
Please go to /example
folder for examples. Also, you can read the documentation for more details.
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.
MIT License
Copyright (c) 2022 Axel