In order to create your first REST API you need to create an API Express project. A project holds one or more APIs.
To create a new project simply click Create new project button. Enter the project name, for example: MyAPIs and enter an optional description. Then click the Create button.
You can also import a previously saved API Express project. If you have the backup file, click Import from backup and select the backup file. To export a backup, go to the Settings page inside the project.
This section explains how to work with folders and start creating services.
Inside a project, you can create one or more folders by clicking the new folder link. A folder allows you to organize your APIs. The folder name will be part of the REST API endpoint name. This is your traditional folder, like on your computer. It's a good idea to give the folder some description. You can now create a sub-folder inside this folder.
To edit or delete a folder, use the edit and delete links.
To start creating a new service click the new service link. In the new service popup you will see the following options:
A group name to organize the services. A group name will be part of the API endpoint.
There are two main ways to create services in API Express.
- If you need to expose a relational database table via APIs, you can use Generate REST API. With this option, APIs will be automatically generated for a database table.
- No other services can be created inside this service group.
- The Custom REST API option will launch the Visual Service Builder where you can create advanced service logic.
- Inside this service group you can only create other custom APIs.
It's a good idea to specify a service description to make it easier to find the service that you need later.
The Service keys page is where you can store keys which can be used by any APIs in this project. For example, it's a good place to store values that don't change or change very rarely such as API keys. Go to the Components Data page and then to the Params section to learn more how to use these keys.
In the project's Settings page, you can:
- Rename or edit the project description.
- Delete the project.
- Export the project backup.
The API key is used in every request to a service, usually appended in the URL.
NOTE: It is incorrect "usually appended in the URL" apiKey is passed in URL for testing purposes and in production mode should be passed as a header
When testing API services show additional error information such as native database SQL errors.
NOTE: It is recommended to disable debug mode when the app is in production because additional error information can contain internal information about the database and etc.
Allow only authenticated users to call REST APIs in this project. Learn how to configure Security security.
API Express custom and generated services have a set of limitations on request and response. In case of exiting these limitations, API Express returns predefined code and message.
Request size can't exceed 5242880 bytes
- API Express code AE018
- HTTP code 413
Body request max size is exceeded.
Response size can't exceed 10241000 bytes and count of records can be more then 1000
- API Express code AE102
- HTTP code 400
Data is too long.
Updated 24 days ago