Les dejo el script de FactoryBot para poblar la base de datos, me lo van a agrader para el minuto 3:50 que se tapa la linea de comando con la barra de herramientas del video.
posts1 = FactoryBot.create_list(:post, 5, user: user_1)
Has construido un API con Ruby on Rails guiado por test-driven development (TDD) y ahora lo ves en acción con Postman, verificando respuestas reales, estados HTTP y autenticación. Aquí encuentras los pasos esenciales para ejecutar el servidor, poblar datos con Factory Bot, y probar endpoints para listar, crear y actualizar posts con cuerpos JSON y headers de autorización.
¿Cómo levantar y comprobar el API con Postman y línea de comando?
Arranca el servidor con el comando de Rails y valida rápidamente que el API responde antes de abrir Postman. También puedes formatear la salida JSON en consola con la herramienta jq para leer mejor las respuestas.
rails s curl http://localhost:3000/help | jq
En Postman, crea un request GET a localhost:3000/help. Allí puedes:
¿Cómo poblar la base de datos con Factory Bot y preparar el entorno?
Para probar endpoints más interesantes como listar posts, primero necesitas datos. Mueve Factory Bot y Faker al entorno de desarrollo en el Gemfile, ejecuta bundle y usa la Rails console para crear usuarios y posts de prueba.
bundle rails c
En la consola:
# Crear usuarios de prueba u1 = FactoryBot.create(:user) u2 = FactoryBot.create(:user) # Crear listas de posts asociados al usuario FactoryBot.create_list(:post, 10, user: u1) FactoryBot.create_list(:post, 10, user: u2)
Consejo útil: el guion bajo _ en Rails console hace referencia al resultado de la última instrucción, lo que agiliza consultas encadenadas.
¿Cómo probar endpoints protegidos: listar, crear y actualizar posts?
Con datos creados, valida el listado, la creación con autenticación y la actualización. Guarda tus requests en una colección de Postman para reutilizarlos.
¿Cómo listar posts con serializer y verificar la respuesta?
En Postman, envía un GET a localhost:3000/posts. Verás:
Guarda este request como “Listar posts” en una colección, por ejemplo: “Platzi blog API”.
¿Cómo crear un post con body JSON y autorización?
Crea un request POST a localhost:3000/posts, con cuerpo en formato raw JSON. La estructura debe incluir el nodo raíz post y llaves entre comillas.
Ejemplo de body:
{ "post": { "title": "Título de ejemplo", "content": "Contenido del post.", "published": true } }
En la Rails console, obtén el token de autenticación del usuario y pégalo en Postman en el header Authorization. Al reenviar, la API crea el post y devuelve status 201 con el contenido creado.
Guarda este request como “Crear post” en la misma colección.
¿Cómo actualizar un post por id y confirmar cambios en la consola?
Para actualizar, usa el id del post. En el ejemplo, se toma el último creado con id 51 y se verifica a qué usuario pertenece. Asegúrate de usar el mismo token de autenticación.
Ejemplo de body para actualizar el título:
{ "post": { "title": "Título actualizado" } }
Incluye el header Authorization con el token y envía la petición. La respuesta devuelve status OK y el nuevo contenido. En la Rails console, usa reload para confirmar que el cambio se guardó en base de datos:
post.reload
Habilidades y conceptos reforzados:
create_list._ y reload.¿Te quedó alguna duda sobre el flujo en Postman, el body JSON o la autorización? Comparte tus preguntas y cuéntanos qué otro endpoint te gustaría probar a continuación.
Has construido un API con Ruby on Rails guiado por test-driven development (TDD) y ahora lo ves en acción con Postman, verificando respuestas reales, estados HTTP y autenticación. Aquí encuentras los pasos esenciales para ejecutar el servidor, poblar datos con Factory Bot, y probar endpoints para listar, crear y actualizar posts con cuerpos JSON y headers de autorización.
Arranca el servidor con el comando de Rails y valida rápidamente que el API responde antes de abrir Postman. También puedes formatear la salida JSON en consola con la herramienta jq para leer mejor las respuestas.
rails s
curl http://localhost:3000/help | jq
En Postman, crea un request GET a localhost:3000/help. Allí puedes:
Para probar endpoints más interesantes como listar posts, primero necesitas datos. Mueve Factory Bot y Faker al entorno de desarrollo en el Gemfile, ejecuta bundle y usa la Rails console para crear usuarios y posts de prueba.
bundle
rails c
En la consola:
# Crear usuarios de prueba
u1 = FactoryBot.create(:user)
u2 = FactoryBot.create(:user)
# Crear listas de posts asociados al usuario
FactoryBot.create_list(:post, 10, user: u1)
FactoryBot.create_list(:post, 10, user: u2)
Consejo útil: el guion bajo _ en Rails console hace referencia al resultado de la última instrucción, lo que agiliza consultas encadenadas.
Con datos creados, valida el listado, la creación con autenticación y la actualización. Guarda tus requests en una colección de Postman para reutilizarlos.
En Postman, envía un GET a localhost:3000/posts. Verás:
Guarda este request como “Listar posts” en una colección, por ejemplo: “Platzi blog API”.
Crea un request POST a localhost:3000/posts, con cuerpo en formato raw JSON. La estructura debe incluir el nodo raíz post y llaves entre comillas.
Ejemplo de body:
{
"post": {
"title": "Título de ejemplo",
"content": "Contenido del post.",
"published": true
}
}
En la Rails console, obtén el token de autenticación del usuario y pégalo en Postman en el header Authorization. Al reenviar, la API crea el post y devuelve status 201 con el contenido creado.
Guarda este request como “Crear post” en la misma colección.
Para actualizar, usa el id del post. En el ejemplo, se toma el último creado con id 51 y se verifica a qué usuario pertenece. Asegúrate de usar el mismo token de autenticación.
Ejemplo de body para actualizar el título:
{
"post": {
"title": "Título actualizado"
}
}
Incluye el header Authorization con el token y envía la petición. La respuesta devuelve status OK y el nuevo contenido. En la Rails console, usa reload para confirmar que el cambio se guardó en base de datos:
post.reload
Habilidades y conceptos reforzados:
create_list._ y reload.¿Te quedó alguna duda sobre el flujo en Postman, el body JSON o la autorización? Comparte tus preguntas y cuéntanos qué otro endpoint te gustaría probar a continuación.
Les dejo el script de FactoryBot para poblar la base de datos, me lo van a agrader para el minuto 3:50 que se tapa la linea de comando con la barra de herramientas del video.
posts1 = FactoryBot.create_list(:post, 5, user: user_1)
Para la creación de registros ya sea de Users o Posts, pueden también crear un archivo en db/seed.rb con el script de creación y ejecutarlo con:
rails db:seed
Puden tener mas detalles en este enlace
en este curso faltó crear usuarios
pregunta, no estoy tomando este curso pero agradeceria si alguien me responde esta pregunta, es que necesito crear una api rest para una web que he creado, pero veo que esta api rest esta en localhost, sera que esta api rest se puede mandar a algun servidor que siempre la mantenga activa para producción? muchas gracias
Cómo se puede subir imágenes utilizando la API con Rails? Por ejemplo, subir una imagen de cada Post del Blog.
Usar el _ para el resultado de la ultima instrucción. TIL
Si tienen problemas con la instalación en windows de jq la opción que seguro funciona es con Chocolatey
**JQ: ** es un lenguaje funcional de muy alto nivel con soporte para backtracking y gestión de flujos de datos JSON.
me sale esto
bash: jq: command not found
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 12 0 12 0 0 1231 0 --:--:-- --:--:-- --:--:-- 1333
(23) Failed writing body
al ejecutar jq .