{"id":28786872,"url":"https://github.com/avastroficial/clover.social-api-bsz","last_synced_at":"2025-08-24T16:12:19.372Z","repository":{"id":298031371,"uuid":"998628514","full_name":"AvastrOficial/clover.social-api-Bsz","owner":"AvastrOficial","description":"Este conjunto de APIs de CloverSpace ofrece acceso directo y sencillo a diferentes tipos de contenido publicados en la plataforma Sin Iniciar Secion o Permitir Que Manipulen Datos, facilitando la creación de aplicaciones web o móviles dinámicas y atractivas.","archived":false,"fork":false,"pushed_at":"2025-06-16T06:14:10.000Z","size":52,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-16T07:26:22.096Z","etag":null,"topics":["api","api-blogs-clover","api-clover","api-cloverapp","api-post-clover","bsz"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AvastrOficial.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-09T01:57:48.000Z","updated_at":"2025-06-16T06:14:14.000Z","dependencies_parsed_at":"2025-06-09T03:34:40.968Z","dependency_job_id":null,"html_url":"https://github.com/AvastrOficial/clover.social-api-Bsz","commit_stats":null,"previous_names":["avastroficial/clover.social-api-bsz"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AvastrOficial/clover.social-api-Bsz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AvastrOficial%2Fclover.social-api-Bsz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AvastrOficial%2Fclover.social-api-Bsz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AvastrOficial%2Fclover.social-api-Bsz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AvastrOficial%2Fclover.social-api-Bsz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AvastrOficial","download_url":"https://codeload.github.com/AvastrOficial/clover.social-api-Bsz/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AvastrOficial%2Fclover.social-api-Bsz/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260432412,"owners_count":23008323,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-blogs-clover","api-clover","api-cloverapp","api-post-clover","bsz"],"created_at":"2025-06-17T20:05:58.534Z","updated_at":"2025-08-24T16:12:19.353Z","avatar_url":"https://github.com/AvastrOficial.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# clover.social-api-Bsz\n\n![Visitas](https://visitor-badge.laobi.icu/badge?page_id=CloverSocialApi\u0026left_text=Visitas\u0026left_color=%23000000\u0026right_color=%238f8f8f)\n\nEste 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.\n\n---\n\n## Descripción general\n\nEste 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.\n\n---\n\n## Funcionalidad principal\n\n- **Gestión de blogs:** Crear, editar, eliminar y listar blogs o posts.\n- **Manejo de usuarios:** Autenticación y control de usuarios que interactúan con los blogs.\n- **Comentarios:** Permite a los usuarios comentar en posts específicos.\n- **Almacenamiento y visualización:** Uso de archivos y bases de datos para almacenar la información de manera eficiente y accesible.\n- **APIs REST:** Comunicación mediante endpoints definidos para facilitar la integración con clientes web, móviles u otras aplicaciones.\n\n---\n\n## APIs incluidas en el proyecto\n\nLas 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:\n\n| API Endpoint                     | Descripción                                                    |\n|---------------------------------|----------------------------------------------------------------|\n| `/blogs`                        | Gestiona operaciones CRUD sobre posts de blogs.               |\n| `/users`                        | Manejo de usuarios: registro, login, perfil.                   |\n| `/comments`                     | Añadir y listar comentarios asociados a posts específicos.    |\n| `/categories`                   | Gestión de categorías para organizar los posts.                |\n| `/files`                       | API para subir y descargar archivos asociados a los posts.    |\n\n### Obtener imágenes en posts recomendados\n\n- **URL base:**  \n  `https://api.cloverspace.io/f/v1/blogs`\n\n| Parámetro      | Valor por ejemplo      | Descripción                          |\n|----------------|-----------------------|------------------------------------|\n| `type`         | `recommend`           | Indica que se quieren publicaciones recomendadas. |\n| `rcmdBlogLabel`| `image`               | Filtra solo los posts que contienen imágenes.      |\n| `size`         | `10`                  | Número máximo de posts a obtener por petición.     |\n| `pageToken`    | (opcional)            | Token para paginación, permite cargar más resultados en páginas siguientes. |\n\n---\n# APIs Clover.Social Blogs\n\n### 1. Obtener posts recientes\n\n- **URL:**  \n  `https://api.cloverspace.io/f/v1/blogs?type=latest\u0026size=10`\n- **Descripción:**  \n  Obtiene los últimos 10 posts publicados, ordenados por fecha de creación para mostrar contenido fresco y actualizado.\n\n### 2. Obtener videos recomendados\n\n- **URL:**  \n  `https://api.cloverspace.io/f/v1/blogs?type=recommend\u0026rcmdBlogLabel=video\u0026size=5`\n\n- **Descripción:**  \n  Obtiene hasta 5 posts recomendados que contienen videos, ideal para mostrar contenido audiovisual destacado.\n\n### 3. Obtener imágenes en posts recomendados\n\n- **URL base:**  \n  `https://api.cloverspace.io/f/v1/blogs`\n\n- **Descripción:**  \n  Recupera posts recomendados que incluyen imágenes, útil para galerías o vistas tipo feed visual.\n\n### 4. Obtener música recomendada\n\n- **URL:**  \n  `https://api.cloverspace.io/f/v1/blogs?type=recommend\u0026rcmdBlogLabel=music\u0026size=10`\n\n- **Descripción:**  \n  Obtiene hasta 10 posts recomendados relacionados con música, para mostrar contenido musical relevante.\n\n---\n\n## ¿Para qué sirve visualizar todo esto?\n\nVisualizar la información que proporcionan estas APIs es crucial para:\n\n- **Interactividad del usuario:** Permite que los usuarios finales puedan ver contenido actualizado, crear nuevos posts o comentar fácilmente.\n- **Gestión centralizada:** Facilita la administración del contenido desde un solo punto mediante interfaces que consumen estas APIs.\n- **Escalabilidad:** Al tener APIs bien definidas, se puede extender la aplicación fácilmente hacia nuevos dispositivos o servicios.\n- **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.\n\n---\n## Regiones y configuración del idioma\n\nPara 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:\n\n```http\nAccept-Language: es-MX,es-AR,es-CO,es-CL,es-PE,es-VE,es-EC,es-CR,es-UY,es-PA,es-DO\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favastroficial%2Fclover.social-api-bsz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Favastroficial%2Fclover.social-api-bsz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favastroficial%2Fclover.social-api-bsz/lists"}