Роман Бугаев @rbugaev «API first approach for frontend developers» Frontend Dev Conf'14 www.fdconf.by

1. API first approach for
frontend developers
Roman Bugaev, API advocate @Adform BY

2. API - part of architecture
• Internal APIs are APIs, Too - The same rules
• Empower front-end
• Front-end developer designs API (UI for data)

3. Design/Pragmatic REST
• REST is an architectural style and not a strict standard
• #1 design principle: to maximize developer productivity
• Pragmatic REST is a design problem
• Keep simple things simple

4. API. Start from Spec/Mock

5. API. Start from Spec/Mock

6. API. Start from Spec/Mock

7. Collaborate
https://github.com/apiaryio/apiblueprint-sdk

8. Agility/HAL
• Amazon
"_links": {
"self": { "href": "/file/987" },
“root": { "href": "/folder/145", "title": “Root" }
}
https://github.com/mikekelly/backbone.hal
http://weluse.github.io/hyperagent/

9. Agility/compatible > beautiful
API Design @ GitHub (100 releases per day, in Adform only 25):
http://tech.yandex.ru/events/yac/2013/talks/1100/

10. Performance/Conditional requests
• ETag - Most responses return an ETag header
• Last-Modified/ If-Modified-Since/ If-None-Match
header
parse: function(response, xhr) {
if (xhr.status === 304)
return this.models
return response.data;
}

11. Thank you! Questions?
roman.bugaev@adform.com
bugaev_roman
http://linkedin.com/in/rbugaev