Я думал, такое бывает только в айтишных страшилках. Но нет — это реальный прод.
Делаем интеграцию. Задача простая: добавить комментарий к сущности в сторонней системе. Присылают Swagger, Postman-коллекцию — всё чинно. Открываю и проваливаюсь в кроличью нору.
Картина маслом: Есть эндпоинт на добавление коммента. Это POST. Казалось бы, логично. Но дальше начинается магия:
Тело запроса (Body) — абсолютно пустое.
Текст комментария, все ID, метаданные — всё запихнуто в URL и PATH параметры.
Что должно произойти в голове человека, чтобы спроектировать API вот так? Это как прийти в ресторан, заказать суп, но вместо того чтобы положить его в тарелку, официант распишет его состав на чеке и скажет: «Ешьте текст».
Почему это больно: Мы часто спорим о «высоких материях», но иногда всё упирается в базу.
- GET — получить.
- POST — создать.
- PUT/PATCH — изменить.
Это не просто «душные правила» из учебников. Это семантика. Это язык, на котором общаются системы. Когда вы его ломаете, вы создаете легаси, которое будет сниться в кошмарах следующим поколениям аналитиков.
К чему я это всё: В «Вайб-аналитике» есть важное правило: структура возникает в процессе, но она должна опираться на фундамент. ИИ — крутой напарник, он может собрать прототип за час, но если вы не понимаете семантику HTTP, вы просто научите нейронку плодить такой же треш быстрее, чем человек.
А какой самый странный эндпоинт видели вы? Пишите в комментах, померимся шрамами. 👇
Дискуссия