MCSKINGEN

Construire avec la bibliothèque publique

Lisez des skins originaux, des textures de blocs et des plans de construction via une API versionnée, avec des sources, des licences et des clés révocables clairement indiquées.

Œuvre approuvée, avec sa source

Recherchez des skins, des packs de textures et des plans de construction, consultez leurs licences et leurs attributions, puis téléchargez les fichiers générés exacts. Les projets privés, les images brutes, les prompts et les tâches sont exclus de cette API.

Télécharger le contrat OpenAPI 3.1

API v1 · contrat 1.1.0 · portée library:read

Quotas de requêtes prévisibles

Chaque clé autorise 60 requêtes par minute et 5000 par jour UTC. Ces requêtes ne consomment pas de crédits de génération. Consultez le quota restant dans les en-têtes de réponse ; respectez Retry-After lors d’une réponse 429.

Mettez en cache avec ETag et If-None-Match. La revalidation vérifie la clé et l’état actuel de publication avant de renvoyer 304. Le contenu retiré renvoie 404 ; les clés révoquées ou expirées renvoient 401.

Créer une clé en lecture seule

Connectez-vous avec votre compte du site web pour créer, consulter et révoquer vos clés d’intégration.

Requêter, consulter, télécharger

Conservez votre clé dans un fichier de configuration de serveur approuvé. Envoyez-la en tant qu’en-tête Authorization. Préservez sourceUrl, author, license et les attributions héritées lors de l’affichage ou de la redistribution d’une œuvre. Les licences non commerciales restent non commerciales.

# 1. Rechercher des skins approuvés
curl 'https://mcskingen.com/api/v1/library/skins?limit=2&model=classic' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY'

# 2. Lire une publication à partir de l’identifiant renvoyé
curl 'https://mcskingen.com/api/v1/library/skins/PUBLICATION_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY'

# 3. Télécharger l’un des fichiers renvoyés
curl 'https://mcskingen.com/api/v1/assets/ASSET_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY' \
  --output original-skin.png

Pour les structures de construction, utilisez /library/buildings?category=houses. Le JSON voxel et le CSV des matériaux sont distincts des fichiers du jeu, qui apparaissent uniquement après la réussite de leurs contrôles de publication.

Pour les packs de ressources de blocs, utilisez /library/textures et les URL de téléchargement renvoyées. Chaque fichier conserve sa version de jeu cible ; les contrôles des fichiers ne certifient pas l’importation dans le client du jeu.

Pour obtenir une autre page, envoyez le nextCursor renvoyé en tant que cursor avec des filtres et une limite inchangés. Un curseur null indique la fin. La recherche prend en charge le texte littéral, la licence et le modèle de bras du skin ; les paramètres non reconnus ou répétés renvoient 400.

Limites d’accès

Connexion et autorisation MCP →

Cette version n’expose que les lectures approuvées de la bibliothèque publique. Les clés API ne peuvent pas créer de tâches, obtenir de devis, consulter un portefeuille, importer des références, gérer des clés ou acheter des crédits. Les sessions de compte du site web gèrent les clés séparément. Les outils MCP utilisent une autorisation OAuth distincte du site web.