---
# System prepended metadata

title: REST API modeling

---

# REST API modeling

We are moving towards a propper rest API. Our routes follow some rules.

## REST resource elements

| verb  | resource   | url                                    |
|------|------------|----------------------------------------|
| GET  | /projects  | /d8fc5ff9-183a-4718-97c8-52f23fb90caa  |

The HTTP verb gives us the first clue about the meaning of a request.
In the example case it says to us that is retrieving some data.

- GET tells that something is being retrieved
- POST means is being created or in a special case that another kind of action is being 

The resource in here a --- that says to us the kind of data that is being retrieved.

URL is a unique resource location, so this rest request is assumed to be always the same object.