/go-rollercoaster-api

Simple "Let's Code" REST API for YouTube

Primary LanguageGoMIT LicenseMIT

go-rollercoaster-api

A simple REST API built for the kubucation YouTube channel

  • No third-party packages/dependencies
  • Used in the "How to use curl as an HTTP Client" video
  • Building of this API available as a video

Requirements

To be able to show the desired features of curl this REST API must match a few requirements:

  • GET /coasters returns list of coasters as JSON
  • GET /coasters/{id} returns details of specific coaster as JSON
  • POST /coasters accepts a new coaster to be added
  • POST /coasters returns status 415 if content is not application/json
  • GET /admin requires basic auth
  • GET /coasters/random redirects (Status 302) to a random coaster

Data Types

A coaster object should look like this:

{
  "id": "someid",
  "name": "name of the coaster",
  "inPark": "the amusement park the ride is in",
  "manufacturer": "name of the manufacturer",
  "height": 27,
}

Persistence

There is no persistence, a temporary in-mem story is fine.