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