thomassdk v1.0.0
Thomas Seo - SDK
An SDK for the Lord of the Rings API.
Installation
npm i thomassdk
Usage
There are 5 different API endpoints to choose from:
- book
- movie
- character
- quote
- chapter
Rules
Each endpoint is set as a class. To use its methods, first create a new instance of the class you want and set as a variable.
All the endpoints except (book) require an access token. To obtain an access token, you must create an account on the website.
- Pass the token as an argument when creating a new instance of an API class.
Invoke the methods to grab the data that you need then log the result to the console to view it.
To handle the async nature of grabbing the data, input a .then
and .catch
after the call.
- Within the
.then
console.log the response object and access itsdata.docs
property to view the data. - Within the
.catch
console.log an error message to display an errors if problem occurs.
Book API
There are 3 different methods to choose from:
getAllBooks()
- Is used to request all the books from the API.
- Has the option of a parameter (object) for inputting filters.
getSpecificBook(id)
- Is used to request a specific book based on the id.
- Requires a valid id (string) of the book.
getSpecificBookChapters(id)
- Is used to request all chapters of one specific book.
- Requires a valid id (string) of the book.
- Has the option of a second parameter (object) for inputting filters.
Movie API
There are 3 different methods to choose from:
getAllMovies()
- Is used to request all the movies from the API.
- Has the option of a parameter (object) for inputting filters.
getSpecificMovie(id)
- Is used to request a specific movie based on the id.
- Requires a valid id (string) of the movie.
getSpecificMovieQuotes(id)
- Is used to request all quotes of one specific movie.
- Requires a valid id (string) of the book.
- Has the option of a second parameter (object) for inputting filters.
- Note: this only works for the Lord of the Rings trilogy.
Character API
There are 3 different methods to choose from:
getAllCharacters()
- Is used to request all the characters and its metadata from the API.
- Has the option of a parameter (object) for inputting filters.
getSpecificCharacter(id)
- Is used to request a specific character based on the id.
- Requires a valid id (string) of the character.
getSpecificCharacterQuotes(id)
- Is used to request all movie quotes of one specific character.
- Requires a valid id (string) of the book.
- Has the option of a second parameter (object) for inputting filters.
Quote API
There are 2 different methods to choose from:
getAllQuotes()
- Is used to request all the movie quotes from the API.
- Has the option of a parameter (object) for inputting filters.
getSpecificQuoteFromMovie(id)
- Is used to request a specific movie quote based on the id.
- Requires a valid id (string) of the quote.
Chapter API
There are 2 different methods to choose from:
getAllChapters()
- Is used to request all the book chapters from the API.
- Has the option of a parameter (object) for inputting filters.
getSpecificChapterFromBook(id)
- Is used to request a specific book chapter based on the id.
- Requires a valid id (string) of the quote.
Options
There is an option for filtering your requests by adding pagination, sorting, and filters.
Rules for using options:
- Must be an object.
- For multiple filtering in one request, separate each key value filter pair by comma.
- Ex:
{limit: 200, symbol: 'budgetInMillions<100'}
- Ex:
Pagination
Property | Description | Type | Default value | Example |
---|---|---|---|---|
limit | Controls the maximum number of items that may be returned | number | 100 | {limit: 200} |
page | Controls what page you want returned | number | 1 | {page: 2} |
offset | Controls the starting point within the collection of resource | number | 0 | {offset: 2} |
Sorting
Property | Description | Type | Default value | Example |
---|---|---|---|---|
asc | Controls if what is returned should be in ascending order | string | '' | {sort: 'name:asc' } |
desc | Controls if what is returned should be in descending order | string | '' | {sort: 'name:desc' } |
Filtering
Property | Description | Type | Default value | Example |
---|---|---|---|---|
match or negate match | Returns data that matches or doesn't match the filter | string | '' | {match: 'budgetInMillions=200'}, {match: 'budgetInMillions!=200'} |
include or exclude | Returns data that includes or excludes the filter | string | '' | {include: 'race=Hobbit'}, {include: 'race!=Hobbit'} |
exists or doesn't exist | Returns data that exists or doesn't exist according to the filter | string | '' | {exists: 'name=Isembold Took'}, {exists: 'name!=Isembold Took'} |
regex | Returns data that passes or doesn't pass the regex | string | '' | {regex: 'name=/foot/i'}, {regex: 'name!=/foot/i'} |
< or > or >= | Returns data that is filtered from the symbol | string | '' | {symbol: 'budgetInMillions<100'}, {symbol: 'budgetInMillions>100'}, {symbol: 'budgetInMillions>=100'} |
Example Setup
import {
BookApi,
MovieApi,
CharacterApi,
QuoteApi,
ChapterApi
} from 'thomassdk'
// token must be in string format
const token = 'put-your-access-token-here';
const grabFromBooks = new BookApi();
const grabFromMovies = new MovieApi(token);
const grabFromCharacters = new CharacterApi(token);
const grabFromQuotes = new QuoteApi(token);
const grabFromChapters = new ChapterApi(token);
//Example requests for books
// grabFromBooks.getAllBooks()
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing all the books!', error))
// grabFromBooks.getSpecificBook('5cf58077b53e011a64671583')
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing a specific book!', error))
// grabFromBooks.getAllBooks({sort: 'name:asc'})
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error grabbing all the chapters of a specific book!', error))
// grabFromBooks.getSpecificBookChapters('5cf58077b53e011a64671583')
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error grabbing all the chapters of a specific book!', error))
//Example requests for movies
// grabFromMovies.getAllMovies()
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing all the movies!', error))
// grabFromMovies.getAllMovies({symbol: 'budgetInMillions>100'})
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing all the movies!', error))
// grabFromMovies.getSpecificMovie('5cd95395de30eff6ebccde58')
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing a specific movie!', error))
// grabFromMovies.getSpecificMovieQuotes('5cd95395de30eff6ebccde5c')
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing quotes from a specific movie!', error))
// grabFromMovies.getAllMovies({match: 'budgetInMillions=200'})
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing all the movies!', error))
// Example requests for characters
// grabFromCharacters.getAllCharacters({include: 'race=Hobbit'})
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing all the characters!', error))
// grabFromCharacters.getAllCharacters({sort: 'name:asc'})
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing all the characters!', error))
// grabFromCharacters.getAllCharacters({exists: 'name=Frodo Baggins'})
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing all the characters!', error))
// grabFromCharacters.getAllCharacters({include: 'race=Hobbit'})
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing all the characters!', error))
// grabFromCharacters.getAllCharacters({regex: 'name!=/foot/i'})
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing all the characters!', error))
// grabFromCharacters.getSpecificCharacter('5cd99d4bde30eff6ebccfd2f')
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing a specific character!', error))
// grabFromCharacters.getSpecificCharacterQuotes('5cd99d4bde30eff6ebccfc15')
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing all the quotes from a character.', error))
// Example requests for quotes
// grabFromQuotes.getAllQuotes()
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing all the movie quotes!', error))
// grabFromQuotes.getSpecificQuoteFromMovie('5cd96e05de30eff6ebcce84b')
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing a specific quote from a movie!', error))
// Example requests for chapters
// grabFromChapters.getAllChapters()
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing all the book chapters!', error))
// grabFromChapters.getAllChapters({exists: 'chapterName=The Black Gate Opens'})
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing all the book chapters!', error))
// grabFromChapters.getSpecificChapterFromBook('6091b6d6d58360f988133bbf')
// .then(response => console.log(response.data.docs))
// .catch(error => console.log('There was an error when grabbing a specific chapter from a book!', error))