1. REST on rails. Пишем API и
клиент

2. REST. Четко и по-хардкору
Когда я первый раз прочитал про REST......

3. REST. Четко и по-хардкору
REST (Representational State Transfer) - передача
состояния представления
Далее мы узнаем …
что ...
состояние – это как раз то, что
отсутствует в архитектуре REST
в отношениях клиент-сервер

4. REST. Четко и по-хардкору
Принцип № 1:
Все является ресурсом
●
… c уникальным идентификатором:
✔ /cities/1/mistresses/23
✔ cities/Ulyanovsk/mistresses/Angelika73

5. REST. Четко и по-хардкору
Принцип № 2:
Объединяй связанные сущности согласно бизнес-
логике
●
Правильно: /cities/1/mistresses/23
Неправильно: /mistresses/23?city_id=1

6. REST. Четко и по-хардкору
Принцип № 3:
Используй стандартные CRUD методы HTTP:
●
DELETE /cities/1/mistresses/23 — это твой бро
POST updatemistress?id=23&city_id=1&action=delete —
это не твой бро

7. REST. Четко и по-хардкору
Принцип № 4:
Множественное представление:
✔ JSON
✔ XML
✔ HTML
Принцип № 5:
Все операции клиента с сервером STATELESS

8. REST. Четко и по-хардкору
Что в итоге?
✔ Простота идеи
✔ Простота разработки
✔ Гибкость
Простое лучше, чем сложное

9. Routes

10. CRUD.Index

11. CRUD.Show

12. CRUD.Create

13. CRUD.update

14. CRUD.destroy

15. Gem 'active_model_serializers'
Назначение - serializers replace hash-driven
development with object-oriented development

16. Gem 'active_model_serializers'

17. Когда сериалайзеры не помогают...

18. Когда сериалайзеры не помогают...

19. Gem 'jbuilder'
show.json.jbuilder:

20. Gem 'jbuilder'
_forecast.json.jbuilder:

21. Тестирование
Парадокс: в православно оттестированном API не
будет багов!

22. Документация
Правило: Документация должна быть прозрачной и
полной, как само API
✔ apipie-rails(no need to learn yet another syntax, you
already know Ruby, right?
✔ yardoc

23. Документация: yardoc

24. Запросы к сторонним API
Каждые 30 секунд надо распарсить новостные RSS
schedule.rb:

25. Запросы к сторонним API
Каждые 30 секунд надо распарсить новостные RSS

26. Запросы к сторонним API
Каждые 30 секунд надо распарсить новостные RSS
daemons/newslist.rb:

27. Ценные советы
✔ Бэкапы — это твой бро
✔ Логи — это твой бро
✔ Админка для вывода информации из БД — это
твой бро
✔ Идти на поводу у менеджеров и frontend-
разработчиков — это не твой бро

28. Клиент к API. Гем weary
Weary is a framework and DSL for building
clients for (preferably RESTful) web
service APIs.
At its most minimal, Weary is simply some
nice syntactic sugar around Net/HTTP.

29. Клиент к API. Гем weary
lib/appstore_client.rb

30. Клиент к API. Гем weary
lib/appstore_client/config.rb

31. Клиент к API. Гем weary
lib/appstore_client/client.rb

32. Клиент к API. Использование
сonfig/initializers/appstore_client.rb

33. Клиент к API. Использование
lib/appstore_service.rb

34. Спасибо за внимание!