In Synatic, you can use the API Builder to design and create your own API definition to build a set of dedicated Routes and EndPoints.
Every API definition will include the OpenAPI (Swagger) specification that the Synatic definition is based on and defines the overall structure of the API.
In this tutorial, we are first going to create the basic root definition of the API.
This implies that we configure only the following:
The APIs Title and description.
The API type.
Once the basic Portal API definition is in place, you can then start adding the rest of the API components in the API Builder's main tabs:
Info. The APIs service and metadata URLs including the API type.
Tags. Tags are used to organize the Endpoints and Routes in the Paths option.
Security Schemes. Security schemes are created to manage various authorization levels. The goal is to describe the security requirements for a given API operation.
An IP Whitelist may be configured to limit access to the API from trusted IP addresses only.
Schema. The schema is metadata that describes how our data is structured.
- Most databases implement some form of schema which will help you to define your APIs data in a more structured manner.
- You can connect various components of your API development and testing process to your schema,
Revisit the Getting Started page for a refresher.
Read more about the API Builder here.