Rest APIs

Question 1

What does REST stand for ?

Answer 1

Representation State Transfer

Question 2

Define your ressource in 4 steps

Answer 2

1. Decide what resource(s) need to be available
2. Assign URLs to the resources
3. Decide what actions the client should be allowed to perform on those resources
4. Figure out what pieces of data are required for each action and what format they should be in.

Question 3

Name 3 best practicies for REST

Answer 3

1. Use nouns not verbs
2. Get and query should not alter the state
3. Use plurals nouns
4. Use sub-ressources for relations
5. Provide Filter, Sort, Paging for all ressources
6. Version your API
7. Handle errors with HTTP status messages (200 = ok, 304 not modified
   400 error

Question 4

How does a filter look like ?

Answer 4

GET /cars?color=red Returns a list of red cars

Question 5

How does a sort look like ?

Answer 5

GET /cars?sort=-manufactorer,+model

Question 6

What is the basic authentication ?

Answer 6

1. URL
2. Method
3. Header
4. Payload

Question 7

How does a version look like ?

Answer 7

/blog/api/v1

Question 8

Handle errors with HTTP status messages

Answer 8

200 – OK – Eyerything is working
201 – OK – New resource has been created
204 – OK – The resource was successfully deleted

304 – Not Modified – The client can use cached data

400 – Bad Request – The request was invalid or cannot be served. The exact error should be explained in the error payload. E.g. „The JSON is not valid“
401 – Unauthorized – The request requires an user authentication
403 – Forbidden – The server understood the request, but is refusing it or the access is not allowed.
404 – Not found – There is no resource behind the URI.
422 – Unprocessable Entity – Should be used if the server cannot process the

Question 9

What headers do you have ?

Answer 9

Get (read)
Post (Create)
PUT (update)
Delete