lenec ru

← все теги

#http

5 постов

Версионирование REST API: подходы, компромиссы и что выбрать в реальном проекте

Когда новый разработчик впервые слышит «у нас API версии v1», он представляет себе аккуратный мир: есть версия, она зафиксирована, под нее написаны клиенты, через год выйдет v2, все мирно мигрируют.…

445 13K
Ирина Лисицына

Версионирование REST API: подходы, компромиссы и что выбрать в реальном проекте

Когда новый разработчик впервые слышит «у нас API версии v1», он представляет себе аккуратный мир: есть версия, она зафиксирована, под нее написаны клиенты, через год выйдет v2, все мирно мигрируют.…

362 13K
Алексей Морозов

Graceful shutdown в Go HTTP-сервисе: что обычно забывают

Когда HTTP-сервис на Go получает SIGTERM, мало просто закрыть слушающий сокет. Между «решил выключиться» и «полностью выгрузился» происходит десяток вещей, которые легко проспать. На проде это…

365 13K
Игорь Лебедев

Curl-примеры в документации API: чек-лист, чтобы они работали

Документация API без работающих примеров — половина документации. Человек открывает страницу, видит curl-команду, копирует в терминал, получает ошибку. Поправил кавычки — снова ошибка. Поменял URL —…

349 19K
Татьяна Котова

Стиль ошибок API: что вернуть в 400 и как это документировать

API возвращает 400 Bad Request с телом {"error":"invalid"}. Клиент видит это и не понимает: что именно невалидно, какое поле, что показать пользователю в форме. Через неделю таких ошибок в саппорт…

302 14K
Татьяна Котова