1.0.2 โข Published 2 years ago
leor-lotr v1.0.2
๐ก What is Lord of the Rings SDK?
This project is an SDK over the Lord of the rings API V2.
๐คธ Getting Started
๐พ Installation
Install leor-lotr via npm:
npm i leor-lotr
๐ First run
First we create a new instance of the exported class. This instance will have all the methods for fetching current data on LOTR.
const LOTRClient = require("leor-lotr");
const client = new LOTRClient("API_KEY");
const getAllLOTRBooks = async () => {
const books = await client.books.get();
console.log("These are all the LOTR books: ", books);
};
getAllLOTRBooks();
๐งช Tests
npm run test
๐ Supported features
The available routes
Method | Response |
---|---|
books.get() | List of all "The Lord of the Rings" books |
books.get({id: ID}) | Request one specific book |
books.get({id: ID, include_child: true}) | Request all chapters of one specific book |
movies.get() | List of all movies, including the "The Lord of the Rings" and the "The Hobbit" trilogies |
movies.get({id: ID}) | Request one specific movie |
movies.get({id: ID, include_child: true}) | Request all movie quotes for one specific movie (only working for the LotR trilogy) |
characters.get() | List of characters including metadata like name, gender, realm, race and more |
characters.get({id: ID}) | Request one specific character |
characters.get({id: ID, include_child: true}) | Request all movie quotes of one specific character |
quote.get() | List of all movie quotes |
quote.get({id: ID}) | Request one specific movie quote |
chapter.get() | List of all book chapters |
chapter.get({id: ID}) | Request one specific book chapter |
Pagination
Method | Response |
---|---|
books.get({ limit: 1 }) | Limit number of results |
books.get({ offset: 1 }) | Get results with offset |
books.get({ page: 1 }) | Get first page of results |
Sorting
Method | Response |
---|---|
books.get({ sort: {field: string, dir: 'asc'|'desc' } }) | Sort by field in ascending or descending order |
๐บ Roadmap
This is Lord of the rings SDK at its first version. There are still many features ahead. You can stay update with our roadmap in this Trello board