Школа
Веб-разработка

Расскажите о дизайне REST API

Руст, Василий и Илья, привет!

Расскажите о дизайне REST API.

Владимир Серёгин
4 янв 2018
👁 4789   🗩1
Веб-разработка

Расскажите о дизайне REST API

Руст, Василий и Илья, привет!

Расскажите о дизайне REST API.

Владимир Серёгин
4 янв 2018
👁 4789   🗩1
Василий Половнёв
Технический директор бюро
Полезно
  
Непонятно
  
Войдите в Бюросферу, чтобы голосовать

REST — это набор принципов для построения гибких и масштабируемых веб‑сервисов. REST полезен, когда вашему приложению нужен внешний интерфейс, с которым будут работать разные клиенты: одностраничное веб‑приложение на Яваскрипте, мобильное приложение на Свифте, внутренний билинг на Эрланге и сторонние сервисы клиентов на любых языках программирования.

В бюро

Бюробилинг — веб‑сервис, отвечающий за продажу продуктов и услуг: подписки, тарифы и автопродление. Определяет, когда и сколько списать по инициативе покупателя, при автопродлении и при других условиях. Подтверждает покупателю операции по почте и в интерфейсе. Напоминает о просроченных платежах. У каждого продукта может быть свой билинг. Метафора — продавец продукта.

Бюрокасса — веб‑сервис, отвечающий за списания с пользователей Бюросферы по заданию билинга, подтверждает списание продавцу. Метафора — бухгалтер и кассир.

Бюробилинги написаны на Руби, ПХП и Яваскрипте и работают с одним и тем же АПИ Бюрокассы, построенном по принципам REST.

Знакомство с REST лучше начать с базовых вещей: ресурсы, урлы, ХТТП и глаголы. Чтобы понять, как всё это связано между собой и зачем, в принципе, нужен REST, советую прочитать:

Чтобы понять, как сделать предсказуемыми и удобными неочевидные вещи типа поиска, сортировки, версионирования и представления ресурсов в JSON, советую прочитать:

Чтобы понять, как подходить к сложным вещам типа пагинации, форматирования ошибок или аутентификации, советую изучить публичные АПИ:

P. S. Это был совет о веб‑разработке. Хотите знать всё о коде, тестах, фронтенд‑разработке, цеэсэсе, яваскрипте, рельсах и джейде? Присылайте вопросы.

Веб‑разработка
Полезно
  
Непонятно
  
Войдите в Бюросферу, чтобы голосовать
Отправить
Поделиться
Поделиться
Запинить
Твитнуть

Комментарии

Стоит дополнить, какие спецификации можно взять на замену REST:

Цель рубрики — обсуждение вопросов дизайна, веб-разработки, переговоров, редактуры и управления.
Комментарии модерируются. Мы публикуем комментарии, которые добавляют к уже сказанному новые мысли и хорошие примеры.

Рекомендуем другие советы