237просмотров
4 февраля 2026 г.
📷 ФотоScore: 261
Недавно мне впервые довелось столкнуться с описанием контрактов API в TypeSpec. TypeSpec - проект с открытым исходным кодом, язык описания API. Имеется кодогенерация как и в OpenAPI и других языках. Однако, главные преимущества TypeSpec: ➕ Намного меньше нужно писать по объёму (сравнение на приложенном скрине, взятом из документации); ➕ Можно описать и http, и protobuf, и асинхронные интеграции на одном языке. Но и минусы тоже имеются: ➖Нужно сделать дополнительные приседания, чтобы писать и компилировать TypeSpec: установить node.js и компилятор TypeSpec (это не так просто, если вы находитесь в России), я потратил пол дня чтобы разобраться с компиляцией и ещё пришлось просить помощи коллег; ➖Формат намного менее читаемый, чем OpenAPI (а может мне пока не хватает насмотренности). Сталкивался ли кто-то из читателей с TypeSpec? Как вам его использование на проекте долгосрочно?
237
просмотров
892
символов
Нет
эмодзи
Да
медиа

Другие посты @safromperm

Все посты канала →
Недавно мне впервые довелось столкнуться с описанием контрак — @safromperm | PostSniper