Как написать api на typescript?

Начните с GET /health без тела запроса. Добавляя прием данных, проверяйте их фактическую структуру: интерфейс TypeScript сам этого не делает.

1. Создайте отдельную учебную папку и инициализируйте npm-проект командой npm init -y. Установите инструменты разработки: npm i -D typescript tsx @types/node. Node.js должен быть установлен заранее.
2. Создайте файл server.ts с минимальным обработчиком. Этот пример отвечает JSON только на GET /health, а для других запросов возвращает 404:

import { createServer } from 'node:http';

type Health = { ok: boolean };

const server = createServer((req, res) => {
  res.setHeader('Content-Type', 'application/json');
  if (req.method !== 'GET' || req.url !== '/health') {
    res.statusCode = 404;
    res.end(JSON.stringify({ error: 'Not found' }));
    return;
  }
  const body: Health = { ok: true };
  res.end(JSON.stringify(body));
});

server.listen(3000, '127.0.0.1');

3. Запустите npx tsx server.ts. Обратитесь к маршруту /health на локальном адресе 127.0.0.1 и порту 3000. Ожидается ответ с полем ok. Привязка к этому адресу предназначена для локального знакомства.
4. Проверьте другой путь и другой метод: они не должны попадать в успешную ветку. Если порт уже занят, сначала выясните, какой процесс его использует, или выберите другой свободный порт.
5. Разделяйте запуск и проверку типов. Средство tsx выполняет подготовку для запуска, но не заменяет отдельную проверку TypeScript в настроенном проекте. Добавьте подходящий tsconfig и выполняйте проверку компилятором.
6. Когда появится тело запроса, ограничьте его размер, обработайте ошибки разбора и проверьте поля во время выполнения. Аннотация Health описывает создаваемый ответ, а объявленный интерфейс для входа не способен заставить внешнего клиента прислать правильные данные.

Хороший пример без базы, сразу видно где выбирается маршрут.