Как описать типи для стороннего API?

Question

[Alex]

Есть сторонний сайт с открытым API. Я бы хотел один раз описать каждый метод, его параметры и ответ, чтобы в дальшейшем в других проектах, не зависимо от того используется ли TS или JS, иметь возможность "подключить" эти типы, чтобы и компилятор и IDE о них знали и использовали. Ну и залить куда-то (npm, github) чтобы и другие люди, при желании могли точно так же "подключить" эти типы и использовать их.

Answer 1

[antoo]

Вам может быть полезна такая вещь, как JSON Schema: это описание полей в виде JSON, из которого можно обратно сгенерировать типы на любых языках. Для JS и TypeScript должны быть готовые решения. Поиграться можно тут: https://app.quicktype.io/#l=schema