Introduction

Welcome to the TheBoyWhoLived API. This documentation should help you to interact with our resources through HTTP requests.

This is a consumption-only API — only the HTTP GET method is available on resources.

Calling any API endpoint without a resource ID or name will return a paginated list of available resources for that API. By default, a list "page" will contain up to 20 resources. You can use 'page' to move to the next page, e.g. ?page=2.

BUT, if you want to help, feel free to reach us out!

Base URL

Every request starts with our Base URL, if response ia a 404 NOT FOUND check the url again.

The documentation is considering all endpoints using the Base URL

https://legacy--api.herokuapp.com/api/v1

Authentication

Authentication is not required.

be happy :)

Resources

Books

Endpoints:

  • /books -- get a list of all books
  • /books/:id -- get a specific books data

Example request:

GET

/books/3

Example response:

  

Characters

Endpoints:

  • /characters -- get a list of all characters
  • /characters/:id -- get a specific characters data

Example request:

GET

/characters/4

Example response:

  

Houses

Endpoints:

  • /houses -- get a list of all houses
  • /houses/:id -- get a specific houses data

Example request:

GET

/houses/1

Example response:

  

Species

Endpoints:

  • /species -- get a list of all species
  • /species/:id -- get a specific species data

Example request:

GET

/species/13

Example response:

  

Wands

Endpoints:

  • /wands -- get a list of all wands
  • /wands/:id -- get a specific wands data

Example request:

GET

/wands/13

Example response: