Use this NodeJS library to access Lord of the Rings API provided by https://the-one-api.dev/.

• Requirements
• Installation
• Quickstart
• Usage
• Tests
• SDK Reference

Use of the Lord of the Rings Node.js SDK requires:

• Node.js 16 or higher

This SDK is for use with Node.js only. It does not support other usages, such as for web browsers or frontend applications.

Using npm

npm install lotr-api

Using yarn

yarn add lotr-api

Using pnpm

pnpm install lotr-api

Before using any of the services, please obtain a access token from https://the-one-api.dev/.

Using commonjs:

const { LOTR } = require('lotr-api')
const lotr = new LOTR({
    accessToken: 'your-access-token'
})

or using ES modules

import { LOTR } from 'lotr-api'
const lotr = new LOTR({
    accessToken: 'your-access-token'
})

Example Usage with async/await

try {
    const movies = await lotr.movies.list()
} catch(err) {
    // handle the error.
}

Available methods to use.

• List

  List of Movies

  const movies = await lotr.movies.list(options)
  

  More detailed information about options and response here

• Get

  Get a Movie by Id

  const movie = await lotr.movies.get(movieId)
  

  More detailed information about response here

• Quotes

  Get list of quotes of a movie

  const quotes = await lotr.movies.quotes(movieId)
  

  More detailed information about response here

• List

  Get List of Quotes

  const quotes = await lotr.quotes.list(options)
  

  More detailed information about options and response here

• Get

  Get a quote by Id

  const quotes = await lotr.quotes.get(id)
  

  More detailed information about response here

To run the testcases follow the below steps.

Clone the repository

git clone https://github.com/hatchways-community/d1f41b78a4cf49f9888a71b5fe729cdb.git
cd d1f41b78a4cf49f9888a71b5fe729cdb

Install the dependencies

npm install

[Note] Create a file .env.test and a variable SANDBOX_TOKEN=your access token for the intergration tests. Also keep in mind that only 100 requests allowed for 10mins. So if you try too many times tests might result in error.

Now run the tests

npm run test

Go through below docs for more detailed information about classes and types sdk reference