Filter
Search the project's routes by a query string and/or by routes properties.
Available filters are:
The Auth filter is only available if your project is set up to support this configuration.
Groups
To manage routes easier, you may want to group them. When creating a new group, you can set its name.
To rename a group, simply insert the new group name in the input field.
Route
Here you have a basic summary of each route defined in your project.
You can find the verb of the the route, its name, the url at which it is reachable and a few optional icons that represent the return type of the route, if it requires authentication, permissions or roles to be accessed and if this route is also an Api endpoint.
When hovering with the mouse over each row, 5 buttons appear on the right side, which allow different operations on the route.
You can assign a new group to the selected route. Typing the name of an existing group will move the route to that group.
If the group that you have typed doesn't exist, a new group will be created containing the selected route.
Alternatively you can copy the route in an existing group, or move it there directly by selecting the destination group.
Routes can be deleted after confirming the deletion in the appearing dialog box.
To edit route settings, expand a row and enter route's details.
Verb
Routes are accessed with verbs. Usually all GET routes are intended for reading, other verbs are intended for creating, updating and deleting.
Select the verb with which the route can be accessed by selecting it from the list. Availables verbs are GET, POST, PUT, and DELETE.
You can optionally input an url suffix for the selected route
.Name
Each route has a name. This helps the route to be easily identifiable across the whole project.
You can choose a name for each route.
Parameters
Routes can have parameters which are passed in the url.
Add a new parameter by clicking the plus button ().
Authentication
You can restrict the access to certain routes to authenticated instances of certain models only.
Check the models you want to be able to reach the route when authenticated. Unauthenticated instances of those models won't be able to reach that route.
Authorization - Roles
You can further limit the access to certain routes so that only authenticated models having certain roles can reach them.
Add a new role by clicking the plus button().
Select the role to which you want to limit the route access. You can add as many such roles as you need.
Authorization - Permissions
Similarly, you can limit the access to certain routes so that only authenticated models having certain permissions can reach them.
Add a new permission by clicking the plus button().
Select the permission to which you want to limit the route access. You can add as many such permissions as you need.
Response
Once a route is executed it will return a response.
For GET routes there are 3 different response types available: