Este repositorio contiene la implementación principal (main) para manejar archivos y consumir las APIs relacionadas con el sistema de Blogs de Clover Social , un proyecto orientado a la gestión y visualización de contenido dinámico a través de APIs REST.
Este proyecto funciona como backend para un sistema de blogs, permitiendo la gestión, almacenamiento y visualización de posts, comentarios y usuarios mediante varias APIs integradas. La estructura y manejo de archivos están diseñados para facilitar la integración con aplicaciones frontend que consumen estas APIs y presentan la información al usuario final.
- Gestión de blogs: Crear, editar, eliminar y listar blogs o posts.
- Manejo de usuarios: Autenticación y control de usuarios que interactúan con los blogs.
- Comentarios: Permite a los usuarios comentar en posts específicos.
- Almacenamiento y visualización: Uso de archivos y bases de datos para almacenar la información de manera eficiente y accesible.
- APIs REST: Comunicación mediante endpoints definidos para facilitar la integración con clientes web, móviles u otras aplicaciones.
Las APIs son el núcleo que permiten la comunicación con el backend. A continuación un resumen de las principales APIs disponibles y su función:
| API Endpoint | Descripción |
|---|---|
/blogs |
Gestiona operaciones CRUD sobre posts de blogs. |
/users |
Manejo de usuarios: registro, login, perfil. |
/comments |
Añadir y listar comentarios asociados a posts específicos. |
/categories |
Gestión de categorías para organizar los posts. |
/files |
API para subir y descargar archivos asociados a los posts. |
- URL base:
https://api.cloverspace.io/f/v1/blogs
| Parámetro | Valor por ejemplo | Descripción |
|---|---|---|
type |
recommend |
Indica que se quieren publicaciones recomendadas. |
rcmdBlogLabel |
image |
Filtra solo los posts que contienen imágenes. |
size |
10 |
Número máximo de posts a obtener por petición. |
pageToken |
(opcional) | Token para paginación, permite cargar más resultados en páginas siguientes. |
- URL:
https://api.cloverspace.io/f/v1/blogs?type=latest&size=10 - Descripción:
Obtiene los últimos 10 posts publicados, ordenados por fecha de creación para mostrar contenido fresco y actualizado.
-
URL:
https://api.cloverspace.io/f/v1/blogs?type=recommend&rcmdBlogLabel=video&size=5 -
Descripción:
Obtiene hasta 5 posts recomendados que contienen videos, ideal para mostrar contenido audiovisual destacado.
-
URL base:
https://api.cloverspace.io/f/v1/blogs -
Descripción:
Recupera posts recomendados que incluyen imágenes, útil para galerías o vistas tipo feed visual.
-
URL:
https://api.cloverspace.io/f/v1/blogs?type=recommend&rcmdBlogLabel=music&size=10 -
Descripción:
Obtiene hasta 10 posts recomendados relacionados con música, para mostrar contenido musical relevante.
Visualizar la información que proporcionan estas APIs es crucial para:
- Interactividad del usuario: Permite que los usuarios finales puedan ver contenido actualizado, crear nuevos posts o comentar fácilmente.
- Gestión centralizada: Facilita la administración del contenido desde un solo punto mediante interfaces que consumen estas APIs.
- Escalabilidad: Al tener APIs bien definidas, se puede extender la aplicación fácilmente hacia nuevos dispositivos o servicios.
- Experiencia de usuario: Brinda una experiencia fluida y dinámica en las plataformas que consumen estas APIs, haciendo posible aplicaciones web y móviles modernas.
Para mejorar la relevancia y localización del contenido, se usa el header HTTP Accept-Language con soporte para múltiples países de habla hispana:
Accept-Language: es-MX,es-AR,es-CO,es-CL,es-PE,es-VE,es-EC,es-CR,es-UY,es-PA,es-DO