Skip to content

Orchestration API for calls to the SWAPI API

License

Notifications You must be signed in to change notification settings

DarWik/ms-starwars

 
 

Repository files navigation

ms-starwars

starwars

The above image was copied from here.

background

What is this?

This is an orchestration of calls to the Star Wars API (SWAPI). The goal is to provide aassociated metadata from SWAPI endpoints with one request.

The SWAPI is a great resource for Star Wars information. SWAPI provides endpoints for Star Wars data specific to:

  • films
  • characters (people)
  • species
  • vehicles
  • starships

This project enables you to make one call to any of these endpoints, and then goes ahead and makes calls to the associated urls for you.

Note that currently all that is returned from calls to the associated urls is the name and id of the value returned

The goal is to have all associated data in one call. Rather than having to walk through the API etc.

routes

This project has the following routes:

  • /films-list

Provides metadata about all the Star Wars films (episodes 1-7).

  • /film/:episode

Provides metadata about a specific Star Wars film. Note provide episode as a parameter.

  • /people/:id

Provides metadata about a specific Star Wars character. Note provide the SWAPI id of the character as a parameter.

  • /planet/:id

Provides metadata about a specific Star Wars planet. Note provide the SWAPI id of the planet as a parameter.

  • /starship/:id

Provides metadata about a specific Star Wars starship. Note provide the SWAPI id of the starship as a parameter.

  • /vehicle/:id

Provides metadata about a specific Star Wars vehicle. Note provide the SWAPI id of the vehicle as a parameter.

  • /species/:id

Provides metadata about a specific Star Wars species. Note provide the SWAPI id of the species as a parameter.

cache

This project uses flat-cache for local caching. A future improvement would be to use redis or memcached as a more robust option.

future improvements

  • PR's welcome!
  • improve testing
  • implement more robust cache mechanism
  • provide better overall docs
  • increase the amount of information returned from the bundled calls (currently only returns the name and id from the SWAPI records)

About

Orchestration API for calls to the SWAPI API

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%