{"id":29698747,"url":"https://github.com/cubiclauncher/bohrium","last_synced_at":"2025-07-23T10:38:39.665Z","repository":{"id":293960235,"uuid":"985619303","full_name":"CubicLauncher/Bohrium","owner":"CubicLauncher","description":"Bohrium es una API REST diseñada para obtener las skins de jugadores premium de Minecraft de forma sencilla y eficiente. Ideal para integraciones en proyectos relacionados con Minecraft, como launchers, servidores, o herramientas de personalización de perfiles.","archived":false,"fork":false,"pushed_at":"2025-05-18T07:04:08.000Z","size":0,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-05-18T07:36:45.330Z","etag":null,"topics":["cubiclauncher","golang","minecraft","webapi"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CubicLauncher.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-05-18T06:48:06.000Z","updated_at":"2025-05-18T07:18:40.000Z","dependencies_parsed_at":"2025-05-18T07:36:47.191Z","dependency_job_id":"7012dfdb-d6b7-413a-9b9c-750dc1845e09","html_url":"https://github.com/CubicLauncher/Bohrium","commit_stats":null,"previous_names":["cubiclauncher/bohrium"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/CubicLauncher/Bohrium","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CubicLauncher%2FBohrium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CubicLauncher%2FBohrium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CubicLauncher%2FBohrium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CubicLauncher%2FBohrium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CubicLauncher","download_url":"https://codeload.github.com/CubicLauncher/Bohrium/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CubicLauncher%2FBohrium/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266664256,"owners_count":23964932,"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","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cubiclauncher","golang","minecraft","webapi"],"created_at":"2025-07-23T10:38:39.115Z","updated_at":"2025-07-23T10:38:39.659Z","avatar_url":"https://github.com/CubicLauncher.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bohrium\n\nAPI REST en Go que permite obtener las skins de jugadores premium de Minecraft usando su nombre de usuario.\n\n## Características\n\n- Obtener la skin completa de un jugador\n- Obtener solo la cabeza del jugador\n- Soporte para CORS\n- Estructura modular y mantenible\n- Manejo de errores robusto\n\n## Estructura del Proyecto\n\n```\nminecraft-skin-api/\n├── handlers/           # Manejadores HTTP\n│   └── skin_handler.go # Maneja las peticiones de skins\n├── models/            # Modelos de datos\n│   └── models.go      # Estructuras de datos\n├── services/          # Lógica de negocio\n│   └── minecraft_service.go # Servicio para interactuar con la API de Minecraft\n└── main.go           # Punto de entrada de la aplicación\n```\n\n## Requisitos\n\n- Go 1.21 o superior\n\n## Instalación\n\n1. Clona este repositorio:\n```bash\ngit clone \u003curl-del-repositorio\u003e\ncd minecraft-skin-api\n```\n\n2. Instala las dependencias:\n```bash\ngo mod download\n```\n\n## Ejecución\n\nPara iniciar el servidor:\n```bash\ngo run main.go\n```\n\nEl servidor se iniciará en `http://localhost:8080`\n\n## Uso de la API\n\n### Obtener la skin completa de un jugador\n\n**Endpoint:** `GET /skin/:username`\n\n**Ejemplo:**\n```bash\ncurl http://localhost:8080/skin/Notch\n```\n\n**Respuesta:**\n```json\n{\n    \"username\": \"Notch\",\n    \"uuid\": \"069a79f444e94726a5befca90e38aaf5\",\n    \"skin_url\": \"https://textures.minecraft.net/texture/...\"\n}\n```\n\n### Obtener solo la cabeza del jugador\n\n**Endpoint:** `GET /skin/:username?head=true`\n\n**Ejemplo:**\n```bash\ncurl http://localhost:8080/skin/Notch?head=true\n```\n\n**Respuesta:**\n```json\n{\n    \"username\": \"Notch\",\n    \"uuid\": \"069a79f444e94726a5befca90e38aaf5\",\n    \"skin_url\": \"https://crafatar.com/avatars/069a79f444e94726a5befca90e38aaf5\"\n}\n```\n\n## Códigos de Error\n\n- `400 Bad Request`: Cuando el nombre de usuario no está presente en la URL\n- `404 Not Found`: Cuando el jugador no existe\n- `500 Internal Server Error`: Cuando hay un error al procesar la petición\n\n## Notas\n\n- La API solo funciona con cuentas premium de Minecraft\n- Si el jugador no existe o no tiene una skin, la API devolverá un error\n- La API incluye CORS habilitado para permitir peticiones desde cualquier origen\n- Las skins se obtienen directamente de los servidores oficiales de Minecraft\n- Las cabezas se obtienen a través del servicio Crafatar\n\n## Contribuir\n\nLas contribuciones son bienvenidas. Por favor, asegúrate de:\n\n1. Hacer fork del repositorio\n2. Crear una rama para tu feature (`git checkout -b feature/AmazingFeature`)\n3. Commit tus cambios (`git commit -m 'Add some AmazingFeature'`)\n4. Push a la rama (`git push origin feature/AmazingFeature`)\n5. Abrir un Pull Request \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcubiclauncher%2Fbohrium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcubiclauncher%2Fbohrium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcubiclauncher%2Fbohrium/lists"}