GET REST. API/MY_Practices 1 

Burak AYDIN 4pps | [email protected] Gdg Ankara @burakaydn 2 

REST REpresentational State Transfer is a architectural style for distributed hypermedia systems. 3 

REST ● Client-server ● Stateless state of the resource ● Cacheable ● Layered system load balancing, cache, etc. ● Uniform interface guiding principles 4 

REST Guiding Principles ●Identification of resources URIs ●Manipulation of resources through these representations representation and it's metadata = enough information to manipulate it ●Self-descriptive messages each message = enough information to process it (MIME, cache, ...) ●Hypermedia as the engine of application state 5 

Glory of REST (Leonard Richardson's Maturity Model) 1. “The Swamp of POX” You’re using HTTP to make RPC calls. HTTP is only really used as a tunnel. 2. Resources Rather than making every call to a service endpoint, you have multiple endpoints that are used to represent resources, and you’re talking to them. 3. HTTP verbs You interact with resources using HTTP verbs, rather than always using POST. 4. HATEOAS Hypermedia Controls. HATEOAS. You’re 100% REST compliant. 6 

HATEOS Hypertext As The Engine Of Application State ■ Used to find your way through the API ■ Actually telling us what is allowed and what not 7 

■ Resource addressed by URI ■ URI Templates ■ HTTP based interactions CRUD API 8 

POST /groups.discuss. replies.edit POST /photos.delete 9 

POST /groups.discuss. replies.edit POST /photos.delete 10 

http://example.org/api/v1/product/123 http://example. org/api/v1/products/123? includes=comments 11 

“ GET should not ALTER the STATE GET /subscriptions/171/cancel PUT /subscriptions/171/cancel 12 

Authorization ■ Basic Authorization over SSL ■ OAuth ■ OAuth2 13 

Pagination https://api.github.com/user/repos? page=2&per_page=100 ■ Link Header #rfc5988 meta: [ link:{ href:"/products/?page=3", rel:"next" } ] 14 

HTTP Caching ■ ETag ■ Last-Modified ■ Cache-Control ■ Expires mnot.net/cache_docs/ 15 

Postman Supercharge API workflow getpostman.com 16 

Other titles ■ HTTP Status codes ■ Rate limiting ■ Error handling 17 

18 Tesekkürler! Sorular? burakaydin.net.tr @burakaydn [email protected] 

Kaynaklar ■ http://restcookbook.com/ ■ https://en.wikipedia.org/wiki/Representational_state_transfer ■ https://speakerdeck.com/robsondealmeida/r-dot-i-p-dot-rest-in-peace- a-guide-through-restful-services ■ https://speakerdeck.com/honzajavorek/rest-api-manual ■ https://developer.github.com/v3/#pagination ■ https://speakerdeck.com/josephruscio/building-restful-apis 19