Escribir a mano las interfaces y tipos para consumir APIs puede ser tedioso y propenso a errores.

El truco

Usa ‘openapi-typescript-codegen’ para generar automáticamente los tipos y servicios API desde un archivo OpenAPI.

Ejecuta:

npx openapi-typescript-codegen --input ./api-spec.yml --output ./src/api

Verás algo así ANTES de usar el generador:

interface User {
  id: number;
  name: string;
  email: string;
}

fetch('/api/users')
  .then(response => response.json())
  .then((data: any) => {
    const users: User[] = data; // Potencial error aquí
  });

Y DESPUÉS, usando el generador:

import { UserService, User } from './src/api';

UserService.getUsers().then((users: User[]) => {
  // El tipado es correcto y automático
});

Con este truco, generas automáticamente código seguro y tipado directamente desde tu especificación OpenAPI. Esto reduce el riesgo de errores manuales y te ahorra tiempo al no tener que escribir los tipos a mano. Además, asegura que tu cliente esté siempre sincronizado con los cambios en la API.

Evita escribir código repetitivo y potencialmente erróneo; usa herramientas que optimicen tu flujo de trabajo.