Книга, которую рекомендую к прочтению, особенно на потоке REST API.
Проектирование веб-API
Лоре Арно
Ключевое:
Разберетесь с назначением программных интерфейсов API
Узнаете про боль: последствия плохо спроектированных API
Познакомитесь с пользователями API и как понять, что они хотят
Организовывать дизайн API, чтобы им было удобно пользоваться, возможно
Защищайте данные в зависимости от контекста: безопасность при работе с API
На вебинарах и обучении я часто это говорю, и не только про API: помните об обратной совместимости! Здесь про это тоже есть
Документирование API - это важно. И круто, если удалось выработать в вашей системе общий подход
Цитаты
Что вы делаете, когда впервые используете какую-либо повседневную вещь? Вы внимательно смотрите на ее интерфейс, чтобы определить ее назначение и то, как ее использовать, основываясь на том, что вы видите, и на своем прошлом опыте. И здесь важен дизайн.
Если вы сосредоточитесь на том, что происходит «под капотом», это приведет к полной катастрофе. Если сфокусироваться на том, что могут делать пользователи, – все пройдет гладко.
Любое представление должно быть легко понятно для людей и программ.
440 страниц Go!
