ta muallif kitobidan iqtiboslar  Паттерны проектирования API

Прежде чем продолжать, нужно подчеркнуть важность того, что значение кода ошибки должно быть уникальным, специфичным и предназначенным для восприятия машиной, а не человеком.
1 kishiga yoqdi
Fikr bildirish
Однозначно определить, что значит «хороший» API, сложно, но обычно они отличаются функциональностью, выразительностью, простотой и предсказуемостью
1 kishiga yoqdi
Fikr bildirish
Пользовательские методы практически всегда должны задействовать HTTP-глагол POST и никогда PATCH. Они также могут использовать глагол GET, если являются
Fikr bildirish
Что, если у пользовательского метода нет состояния для обработки и его не нужно привязывать к ресурсу или коллекции?» Такой метод, называемый методом без сохранения
Fikr bildirish
ним ресурсом или с родительской коллекцией. Таблица 9.1. Различные аспекты импорта и экспорта данных
Fikr bildirish
в данном случае целью выступает операционный, выразительный, простой и прогнозируемый API. И когда дизайн уводит от этого, практически всегда будет лучше настроить инструменты под соответствие потребностям API, а не наоборот
Fikr bildirish
Прежде чем подвести итог, нужно ответить еще на один важный вопрос: почему бы не переупорядочить ресурсы так, чтобы нужные нам действия больше соответствовали функционалу стандартных методов? В этом примере можно использовать ресурсы EmailDraft и Email, в которых мы не хотим переходить между состояниями, вместо чего создаем новый ресурс Email, основанный на EmailDraft (листинг 9.2
Fikr bildirish
ь чувство, будто мы слепо следуем букве закона, но не его духу
Fikr bildirish
Patch (RFC-7396; https://tools.ietf.org/html/rfc7396), который немного ближе к изученной
Fikr bildirish
зависящей от того, с каким ресурсом происходит взаимодействие, будет вести к неожиданностям
Fikr bildirish