• do not have a complete understanding of what your existing tools can offer.
• need to grow and change your API from the initial implementation
• want to set up and run an API from an early stage of the production to easilyenvision the big picture of the end product.There are various tools available to LoopBack which allows this bottom-upapproach of building your application to be simple through the usages ofmetadata and decorators.

With TypeScript’sfeature, APIs can be automatically built and exposed as your applicationcontinues development. Some key concepts utilize decorators to gather _metadata_about your code and then assemble them into a valid OpenAPI specification, whichprovide a description of your API. These concepts and their decorators include:

• Model
  • @property()

Your models act as common definitions between data being handled by the APIlayer and the datasource layer. Since your API is going to be built around themanipulation of models and their properties, they will be the first to bedefined.

Note:

Todo model from is used for demonstration here.

First, write a simple TypeScript class describing your model and its properties:

To this representation of your model, we can use the @model and decorators to create the model’s metadata; a model definition. LoopBack andLoopBack extensions can use this model definition for a wide variety of uses,such as:

• generating OpenAPI schema for your APIs
• validating instances of the models during the request/response lifecycle
• automatically inferring relationships between models during datasourceoperationsTo apply these decorators to your model, you simply prefix the class definitionwith the @model decorator, and prefix each property with the @propertydecorator:

src/models/todo.model.ts

Note:

TodoController from tutorialis used for demonstration here.

Once your models are defined, create a controller to host your routes for each of your API:

The controller’s routes in their current state has no information on which APIendpoints they belong to. Add them in by appending @operation to each methodof your routes and @param or to its parameters:

src/controllers/todo.controller.ts

Once your routes have been decorated, your application is ready to serve itsAPI. When an instance of RestServer is run, an OpenAPI specificationrepresenting your application’s API is built. The spec is generated entirelyfrom the decorated elements’ metadata, which in turn provides routing logic foryour API when your application is running.

To review your complete API specification, run your application with thedecorated controllers registered. Once it is running, visit /openapi.jsonendpoint to access your API specification in JSON format or /openapi.yaml forYAML. Alternatively, the specification file can also be accessed in code throughthe getApiSpec() function from your RestServer instance.

For a complete walkthrough of developing an application with the bottom-upapproach, see ourTodo applicationtutorial.