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