backend-comision-1-2023-argentina-programa-4.0

Desafíos y ejercicios. Construcción de aplicaciones de servidor (back-end). Creación de servicios web que proveen datos a aplicaciones web front-end, aplicaciones de escritorio como también aplicaciones móviles. Creación y administración de bases de datos SQL y noSQL, e integradas éstas a los servicios web.

API de Posts con Node.js, Express y Sequelize

Esta es una API de ejemplo que utiliza Node.js, Express y Sequelize para gestionar posts, comentarios, usuarios, etiquetas y categorías. A continuación, encontrarás la documentación para utilizar esta API.

Modelo - Entidad - Relación

Entidades - Atributos

Relaciones

Modelo Físico

Modelo Físico (Modoficando Relación Muchos a Muchos Posts - Etiquetas)

Requisitos Previos

Asegúrate de tener Node.js y MySQL instalados en tu sistema antes de ejecutar la aplicación. Además, crea una base de datos MySQL y configura las credenciales en un archivo .env en la raíz del proyecto como se muestra en el siguiente ejemplo.

Archivo .env

Configuración de la base de datos

DB_HOST=localhost
DB_PORT=3000
DB_NAME=mi_basededatos(en este caso Posts)
DB_USER=mi_usuario(root)
DB_PASSWORD=mi_contraseña_secreta_de_mysql

Instalación

1. Clona este repositorio:

   git clone https://github.com/urldelproyecto...
   

2. Navega al directorio del proyecto:

   cd posts...
   

3. Instala las dependencias:

   npm install
   

4. Inicia el servidor:

   npm start
   

La API estará disponible en http://localhost:3000.

Endpoints

A continuación, se detallan los endpoints disponibles y cómo utilizarlos:

Categorías

Listar todas las categorías

• URL: /api/categorias
• Método: GET
• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    [
      {
        "Categoria_id": 1,
        "Nombre_categoria": "Tecnología"
      },
      {
        "Categoria_id": 2,
        "Nombre_categoria": "Deportes"
      }
    ]
    

Crear una nueva categoría

• URL: /api/categorias

• Método: POST

• Cuerpo de la Petición:

  {
    "Nombre_categoria": "Ciencia"
  }
  

• Respuesta Exitosa:

  • Código: 201 Created

  • Ejemplo de Respuesta:

    {
      "Categoria_id": 3,
      "Nombre_categoria": "Ciencia"
    }
    

Obtener una categoría por ID

• URL: /api/categoria/:id
• Método: GET
• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    {
      "Categoria_id": 1,
      "Nombre_categoria": "Tecnología"
    }
    

Actualizar una categoría por ID

• URL: /api/categoria/:id

• Método: PUT

• Cuerpo de la Petición:

  {
    "Nombre_categoria": "Tecnología e Innovación"
  }
  

• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    {
      "Categoria_id": 1,
      "Nombre_categoria": "Tecnología e Innovación"
    }
    

Eliminar una categoría por ID

• URL: /api/categoria/:id
• Método: DELETE
• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    {
      "mensaje": "Categoría eliminada con éxito"
    }
    

Comentarios

Listar todos los comentarios

• URL: /api/comentarios
• Método: GET
• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    [
      {
        "Comentario_id": 1,
        "Contenido_comentario": "Excelente artículo",
        "Usuario_ID": 1,
        "Post_ID": 1
      },
      {
        "Comentario_id": 2,
        "Contenido_comentario": "Gracias por compartir",
        "Usuario_ID": 2,
        "Post_ID": 1
      }
    ]
    

Crear un nuevo comentario

• URL: /api/comentarios

• Método: POST

• Cuerpo de la Petición:

  {
    "Contenido_comentario": "Gran publicación",
    "Usuario_ID": 1,
    "Post_ID": 2
  }
  

• Respuesta Exitosa:

  • Código: 201 Created

  • Ejemplo de Respuesta:

    {
      "Comentario_id": 3,
      "Contenido_comentario": "Gran publicación",
      "Usuario_ID": 1,
      "Post_ID": 2
    }
    

Obtener un comentario por ID

• URL: /api/comentario/:id
• Método: GET
• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    {
      "Comentario_id": 1,
      "Contenido_comentario": "Excelente artículo",
      "Usuario_ID": 1,
      "Post_ID": 1
    }
    

Actualizar un comentario por ID

• URL: /api/comentario/:id

• Método: PUT

• Cuerpo de la Petición:

  {
    "Contenido_comentario": "Gran artículo"
  }
  

• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    {
      "Comentario_id": 1,
      "Contenido_comentario": "Gran artículo",
      "Usuario_ID": 1,
      "Post_ID": 1
    }
    

Eliminar un comentario por ID

• URL: /api/comentario/:id
• Método: DELETE
• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    {
      "mensaje": "Comentario eliminado con éxito"
    }
    

Etiquetas

Listar todas las etiquetas

• URL: /api/etiquetas
• Método: GET
• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    [
      {
        "Etiqueta_id": 1,
        "Nombre_etiqueta": "Node.js"
      },
      {
        "Etiqueta_id": 2,
        "Nombre_etiqueta": "Express"
      }
    ]
    

Crear una nueva etiqueta

• URL: /api/etiquetas

• Método: POST

• Cuerpo de la Petición:

  {
    "Nombre_etiqueta": "Sequelize"
  }
  

• Respuesta Exitosa:

  • Código: 201 Created

  • Ejemplo de Respuesta:

    {
      "Etiqueta_id": 3,
      "Nombre_etiqueta": "Sequelize"
    }
    

Obtener una etiqueta por ID

• URL: /api/etiqueta/:id
• Método: GET
• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    {
      "Etiqueta_id": 1,
      "Nombre_etiqueta": "Node.js"
    }
    

Actualizar una etiqueta por ID

• URL: /api/etiqueta/:id

• Método: PUT

• Cuerpo de la Petición:

  {
    "Nombre_etiqueta": "Node.js y Express"
  }
  

• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    {
      "Etiqueta_id": 1,
      "Nombre_etiqueta": "Node.js y Express"
    }
    

Eliminar una etiqueta por ID

• URL: /api/etiqueta/:id
• Método: DELETE
• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    {
      "mensaje": "Etiqueta eliminada con éxito"
    }
    

Tabla Post_etiquetas

La tabla Post_etiquetas se utiliza para mantener un registro de las relaciones entre las publicaciones y las etiquetas. Esta tabla es esencial para implementar una relación de muchos a muchos entre las publicaciones y las etiquetas, ya que permite asociar múltiples etiquetas con múltiples publicaciones.

Esquema de la tabla

Campo	Tipo	Descripción
id	Entero	Identificador único de la relación.
post_id	Entero	Clave foránea que hace referencia a la tabla Publicaciones.
etiqueta_id	Entero	Clave foránea que hace referencia a la tabla Etiquetas.

Relaciones

• post_id: Esta columna se relaciona con la tabla Publicaciones y representa la publicación a la que se asocia una etiqueta.
• etiqueta_id: Esta columna se relaciona con la tabla Etiquetas y representa la etiqueta asociada a una publicación.

Ejemplo de uso

Supongamos que tenemos las siguientes entradas en la tabla Post_etiquetas:

id	post_id	etiqueta_id
1	101	5
2	102	6
3	103	5

Esto indica que:

• La publicación con id 101 está asociada a la etiqueta con id 5.
• La publicación con id 102 está asociada a la etiqueta con id 6.
• La publicación con id 103 está asociada a la etiqueta con id 5.

Esta relación permite etiquetar múltiples publicaciones con las mismas etiquetas y realizar consultas relacionadas con las etiquetas asociadas a una publicación específica o las publicaciones asociadas a una etiqueta.

Endpoints de Post_etiquetas

Aquí se describen los endpoints relacionados con esta funcionalidad.

Crear un nuevo registro de Post_Etiquetas

• URL: /api/posts_etiquetas

• Método: POST

• Cuerpo de la Petición:

  {
    "Post_ID": 1,
    "Etiqueta_ID": 2
  }
  

• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    {
      "Post_etiqueta_ID": 1,
      "Post_ID": 1,
      "Etiqueta_ID": 2
    }
    

Obtener todos los registros de Post_Etiquetas

• URL: /api/posts_etiquetas
• Método: GET
• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    [
      {
        "Post_etiqueta_ID": 1,
        "Post_ID": 1,
        "Etiqueta_ID": 2
      },
      {
        "Post_etiqueta_ID": 2,
        "Post_ID": 2,
        "Etiqueta_ID": 1
      }
    ]
    

Actualizar un registro de Post_Etiquetas por ID

• URL: /api/post_etiqueta/:id

• Método: PUT

• Cuerpo de la Petición:

  {
    "Post_ID": 3,
    "Etiqueta_ID": 4
  }
  

• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    {
      "Post_etiqueta_ID": 1,
      "Post_ID": 3,
      "Etiqueta_ID": 4
    }
    

Eliminar un registro de Post_Etiquetas por ID

• URL: /api/post_etiqueta/:id
• Método: DELETE
• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    {
      "message": "Registro de Post_Etiquetas eliminado exitosamente"
    }
    

Usuarios

Listar todos los usuarios

• URL: /api/usuarios
• Método: GET
• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    [
      {
        "Usuario_id": 1,
        "Nombre_usuario": "usuario1",
        "Correo_electronico": "usuario1@example.com"
      },
      {
        "Usuario_id": 2,
        "Nombre_usuario": "usuario2",
        "Correo_electronico": "usuario2@example.com"
      }
    ]
    

Crear un nuevo usuario

• URL: /api/usuarios

• Método: POST

• Cuerpo de la Petición:

  {
    "Nombre_usuario": "usuario3",
    "Correo_electronico": "usuario3@example.com"
  }
  

• Respuesta Exitosa:

  • Código: 201 Created

  • Ejemplo de Respuesta:

    {
      "Usuario_id": 3,
      "Nombre_usuario": "usuario3",
      "Correo_electronico": "usuario3@example.com"
    }
    

Obtener un usuario por ID

• URL: /api/usuario/:id
• Método: GET
• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    {
      "Usuario_id": 1,
      "Nombre_usuario": "usuario1",
      "Correo_electronico": "usuario1@example.com"
    }
    

Actualizar un usuario por ID

• URL: /api/usuario/:id

• Método: PUT

• Cuerpo de la Petición:

  {
    "Nombre_usuario": "nuevo_nombre_usuario"
  }
  

• Respuesta Exitosa:

  • Código: 200 OK

  • Ejemplo de Respuesta:

    {
      "Usuario_id": 1,
      "Nombre