David Suárez-Otero

OnePieceAPI

API REST en ASP.NET Core que actúa de intermediaria sobre una API pública de One Piece, traduciendo los modelos a español para consumo por clientes propios.

  • .NET 10
  • ASP.NET Core Web API
  • HttpClient (IHttpClientFactory)
  • System.Text.Json
  • OpenAPI

Problema

Consumir una API externa directamente desde un cliente implica acoplarse a su idioma, forma y disponibilidad.

Solución

Un backend intermediario propio que normaliza y traduce la respuesta, aislando a cualquier cliente futuro de la API externa.

Descripción completa

Patrón Backend-for-Frontend simple pero real: Cliente → OnePieceAPI → api-onepiece.com → respuesta mapeada. Seis recursos (Personajes, Espadas, Frutas, Tripulaciones, Haki, Barcos) con localización de datos como valor añadido, no solo un proxy 1:1.

Arquitectura

Controller → Service (HttpClient vía IHttpClientFactory) → API externa → modelos en español.

Funcionalidades principales

  • Seis recursos con tres patrones de endpoint cada uno: todos, por ID, múltiples IDs
  • Documentación OpenAPI en entorno de desarrollo

Decisiones técnicas

  • Traducción/localización de los modelos como valor añadido, no un proxy transparente 1:1

Aprendizajes

Ejercicio de aprendizaje de consumo de APIs externas y del patrón Backend-for-Frontend en ASP.NET Core — es también la base real que sostiene el guiño de One Piece en este portfolio, no un gadget sin sustancia.