MCSKINGEN

Desarrolla con la biblioteca pública

Consulta skins originales, texturas de bloques y planos de construcción mediante una API versionada, con fuentes explícitas, licencias y claves revocables.

Obras aprobadas, con su fuente

Busca skins, paquetes de texturas y planos de construcción, consulta sus licencias y atribuciones y, después, descarga los archivos generados exactos. Los proyectos privados, las imágenes sin procesar, las instrucciones de generación y los trabajos quedan fuera de esta API.

Descargar el contrato OpenAPI 3.1

API v1 · contrato 1.1.0 · ámbito library:read

Cuotas de solicitudes predecibles

Cada clave permite 60 solicitudes por minuto y 5000 por día UTC. Estas solicitudes no consumen créditos de generación. Consulta la cuota restante en las cabeceras de respuesta; respeta Retry-After cuando recibas un 429.

Usa la caché con ETag e If-None-Match. La revalidación comprueba la clave y el estado de publicación actual antes de devolver 304. El contenido retirado devuelve 404; las claves revocadas o caducadas devuelven 401.

Crear una clave de solo lectura

Inicia sesión con tu cuenta del sitio web para crear, consultar y revocar tus claves de integración.

Consulta, examina y descarga

Guarda tu clave en un archivo de configuración de un servidor de confianza. Envíala en una cabecera Authorization. Conserva sourceUrl, author, license y las atribuciones heredadas al mostrar o redistribuir una obra. Las licencias no comerciales siguen siendo no comerciales.

# 1. Buscar skins aprobadas
curl 'https://mcskingen.com/api/v1/library/skins?limit=2&model=classic' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY'

# 2. Leer una publicación a partir de su identificador devuelto
curl 'https://mcskingen.com/api/v1/library/skins/PUBLICATION_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY'

# 3. Descargar uno de los recursos devueltos
curl 'https://mcskingen.com/api/v1/assets/ASSET_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY' \
  --output original-skin.png

Para estructuras de construcción, usa /library/buildings?category=houses. El JSON de vóxeles y el CSV de materiales son independientes de los archivos del juego, que solo aparecen después de superar sus comprobaciones de publicación.

Para paquetes de recursos de bloques, usa /library/textures y las URL de descarga que devuelve. Cada archivo conserva su versión de destino del juego; las comprobaciones de archivos no certifican la importación en el cliente del juego.

Para obtener otra página, envía el nextCursor devuelto como cursor sin cambiar los filtros ni limit. Un cursor null indica el final. La búsqueda admite texto literal, licencia y modelo de brazos de la skin; los parámetros no reconocidos o repetidos devuelven 400.

Límites de acceso

Conexión y autorización de MCP →

Esta versión solo permite lecturas aprobadas de la biblioteca pública. Las claves de API no pueden crear trabajos, obtener presupuestos, consultar un monedero, subir referencias, gestionar claves ni comprar créditos. Las sesiones de las cuentas del sitio web gestionan las claves por separado. Las herramientas MCP usan una autorización OAuth independiente en el sitio web.