continuing spec on first api routes and learning RAML