MAL API
A Dart wrapper for the official MyAnimeList REST API.
Tests and Examples
To run the example in the example directory, ensure that the following enviroment variables are set:
CLIENT_ID- obtained after registering your application at MAL's API ConfigCLIENT_SECRET- obtained after registering your application at MAL's API ConfigREDIRECT_URL- the URL to redirect to after oauth2 authentication (must be specified in theApp Redirect URLfield at MAL's API Config)
To run the tests in the test directory, ensure that the following environment variables are set:
CREDENTIALS- JSON string containing your oauth2 credentials (generated and stored in thecreds.jsonfile whenexample/mal_api_example.dartis runned)CLIENT_ID- obtained after registering your application at MAL's API ConfigCLIENT_SECRET- obtained after registering your application at MAL's API Config
Before running the tests, do note that some test will make modifications to your anime and manga list.
Getting Started
To start making request to the MyAnimeList API, you will need a Client object. A Client object can be obtained by calling Authenticator::authenticate(). Refer to the example for more information.
At any point in time, if a request to the MyAnimeList API fails, a ClientException will be thrown.
Most Client methods have a fields parameter. Certain Fields can also have sub-Fields. This is use to specify which fields the MyAnimeList API should return. Certain fields are always returned by the API. However, to ensure that the field you need will be returned, specify it explicitly. Note that even if a field is explicitly specified, there are times (e.g. missing information) where the field will not be returned. Thus, make sure to check for null values.
Example
See example/mal_api_example.dart.
License
Distributed under the MIT License. See LICENSE for more information.