Creación de APIs con Rails: Proyecto Blog API paso a paso

Crear una API con Rails puede ser rápido y claro si usas los flags correctos y entiendes qué cambia frente a una app completa. Aquí verás el comando esencial, la estructura generada y los ajustes clave para empezar con confianza.

¿Cómo crear un proyecto Rails API con flags correctos?

Para generar solo lo necesario para una API, usa el generador con el flag de API y desactiva las pruebas por defecto para preparar el proyecto hacia RSpec.

rails new NOMBRE_DEL_PROYECTO --api -T

¿Por qué usar el flag API?

• Genera solo lo necesario para una API.
• Excluye lo relacionado a vistas y front-end.
• Optimiza la estructura y el arranque del proyecto.

¿Para qué sirve el flag -T?

• Evita que se agregue Minitest por defecto.
• Prepara el terreno para integrar RSpec después.
• Ahorra tiempo y evita archivos de prueba que no usarás.

Puntos clave: - Minitest: librería de pruebas incluida por defecto en Rails. - RSpec: librería alternativa para pruebas, más completa y con muy buena integración con Rails.

¿En qué se diferencia Rails completo de una API?

La diferencia vive en el arranque del framework y en los controladores base. Esto reduce dependencias de vistas y te deja un backend más ligero.

¿Qué cambia en Application.rb?

• En una app completa suele cargarse todo con algo equivalente a “Rails All”.
• En modo API, el generador incluye solo los módulos necesarios y excluye lo de vistas.
• Beneficio: arranque más rápido y menos archivos innecesarios.

¿Qué hereda ApplicationController?

En una app completa: - ApplicationController hereda de ActionController::Base.

En una API: - ApplicationController hereda de ActionController::API, especializado para APIs.

Ejemplo:

class ApplicationController < ActionController::API
end

Además, verás una estructura común con carpetas como Channels, Controllers, Jobs, Mailers, Models y Views; en modo API se prescinde de lo relacionado a vistas al momento de generar archivos.

¿Cómo verificar y versionar el proyecto con Git?

El generador crea un .gitignore adaptado para Rails, listo para iniciar control de versiones con Git.

¿Qué genera el .gitignore?

• Reglas para logs, dependencias y archivos temporales.
• Configuración base para mantener el repositorio limpio.

Primer commit:

git add -A
git commit -m "initial commit"

¿Cómo ejecutar el servidor y comprobar en localhost?

Inicia el servidor:

rails s
# o
rails server

Luego visita localhost:3000. Verás la pantalla por defecto de Rails que confirma que todo funciona y muestra las versiones de Rails y Ruby.

Si te interesa, en el siguiente paso se configura RSpec y Factory Bot para las pruebas.

¿Te quedó alguna duda sobre los flags, la herencia del ApplicationController o el arranque en localhost? Deja tu comentario y cuéntame qué te gustaría profundizar.