18.09.2025
Большая часть работы современных айтишников так или иначе завязана на API - это такие публичные интерфейсы, через которые программы общаются друг с другом.
Автору не раз приходилось писать публичные API для сторонних разработчиков, внутренние - для своих сервисов, REST и GraphQL-интерфейсы, и даже не сетевые штуки вроде CLI-утилит.
И так же, как и в разработке обычного софта, он считает, что многие советы по проектированию API излишне усложнены. Народ часто спорит о том, что такое "настоящий REST", нужен ли HATEOAS, и так далее. В этой статье он решил просто и без воды рассказать обо всём, что узнал за годы работы о том, как делать API, которые удобно использовать.
