In this section we explain the different types of routes and endpoint endpoints found in Modzy.
In general terms, our endpoints start with the microservice followed by the object actioned. Sometimes, they accept variables and other parameters.
Create, update, and delete routes
In general terms, routes used to create entities, use the PUT method. Routes used to update entities, use the PATCH method. Routes used to logically delete entities or relationships between them use the DELETE method. But if any of these routes require a request body, they use the POST method.
Anytime a request doesn’t match the standard logic, we use the POST method as a wildcard.
Routes used for querying use either GET or POST. We have three types of query routes: the collection, detail, and parallel search routes.
These routes use the GET method and accept pagination and query parameters in the URL. If you intend to use pagination parameters, simply add ? to the end of the route and insert the parameters right after. They sort and filter the results based on the parameters provided. If no pagination parameters are sent, then the API returns the entire collection of resulting data.
These routes also use the GET method but instead of pagination and query parameters, they accept an entity identifier. Except for this, they generally look just like the collection routes. They return all the existing details for the entity provided.
Parallel search routes
These routes provide a search alternative and use the POST method. They have the noun search and require that either an array of entity identifiers is sent in the request body or an entity identifier is sent in the endpoint. Instead of returning the details about an entity, they return the details for the multiple entities provided in the request body.