by Roman Melnyk, Web developer, SoftServe

1. REST that won't make you cry
Roman Melnyk,
Web developer,
SoftServe
2014

2. Topics to cover
Client-server data interchange
REST
Lingual principles
HTTP
feat. pictures, marginal jokes, guns and explicit lexicon

4. Data handling

7. Lingual principles
Yo serva, gimme sum userz, bro!

8. Lingual principles
GET 127.0.0.1 /api/users

11. Outgoing data
GET /api/users
• GET /api/users/12
• GET /api/users ?loginMask=rmel&createdAfter=2012-12-12
POST /api/users
• POST /api/users/12
PUT /api/users/12
• PUT /api/users ← sure to do this?
DELETE /api/users/12
• DELETE /api/users ← DONT EVEN TRY!!!1111

12. Outgoing data
POST and PUT require data:
• Content-Type:
◦application/json
◦application/xml
◦multipart/form-data
◦text/plain
◦text/html
◦text/xml

13. Incoming data
Response code:
• 2xx
• 4xx
◦400 Bad Request, 405 Method not allowed
◦401 GTFO Unauthorized
◦403 Forbidden
• 5xx

14. Incoming data
Headers:
• Access-Control-Allow-Origin
• Cache-Control, Expires, Pragma
• Content-Encoding
• Content-Language
• Content-Length
• Set-Cookie

16. Incoming data
Content-Type must respect MIME types
for both text and binary content

17. Incoming data
@GET
@Path("api/users/{id}")
@Produces("application/json")
public User getUserInfo(
@PathParam("id") String uid,
@QueryParam("filter") String filter
) throws ApiException;

18. “Always code
as If the guy who ends up
maintaining your code
will be a violent psychopath
who knows where you live.
— Martin Golding

19. Spend some time
http://www.restapitutorial.com/
http://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol
http://www.iana.org/assignments/http-status-codes/http-status-codes.
xhtml