MCSKINGEN

Sviluppa con la libreria pubblica

Leggi skin originali, texture dei blocchi e progetti di costruzioni tramite un'API versionata, con fonti esplicite, licenze e chiavi revocabili.

Opere approvate, con la relativa fonte

Cerca skin, pacchetti di texture e progetti di costruzioni, consulta le licenze e le attribuzioni, quindi scarica i file generati esatti. I progetti privati, le immagini originali, i prompt e i job non sono inclusi in questa API.

Scarica il contratto OpenAPI 3.1

API v1 · contratto 1.1.0 · ambito library:read

Quote di richieste prevedibili

Ogni chiave consente 60 richieste al minuto e 5000 per giorno UTC. Queste richieste non consumano crediti di generazione. Consulta la quota residua nelle intestazioni della risposta; in caso di 429, rispetta Retry-After.

Usa la cache con ETag e If-None-Match. La rivalidazione controlla la chiave e lo stato di pubblicazione corrente prima di restituire 304. I contenuti ritirati restituiscono 404; le chiavi revocate o scadute restituiscono 401.

Crea una chiave di sola lettura

Accedi con il tuo account del sito per creare, consultare e revocare le chiavi di integrazione.

Interroga, esamina, scarica

Conserva la chiave in un file di configurazione server attendibile. Inviala nell'intestazione Authorization. Quando mostri o ridistribuisci un'opera, conserva sourceUrl, author, license e le attribuzioni ereditate. Le licenze non commerciali restano non commerciali.

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

# 2. Leggi una pubblicazione tramite l'ID restituito
curl 'https://mcskingen.com/api/v1/library/skins/PUBLICATION_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY'

# 3. Scarica una delle risorse restituite
curl 'https://mcskingen.com/api/v1/assets/ASSET_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY' \
  --output original-skin.png

Per le strutture di costruzione, usa /library/buildings?category=houses. Il JSON voxel e il CSV dei materiali sono separati dai file di gioco, disponibili solo dopo il superamento dei relativi controlli di rilascio.

Per i pacchetti di risorse dei blocchi, usa /library/textures e gli URL di download restituiti. Ogni file conserva la versione del gioco di destinazione; i controlli sui file non certificano l'importazione nel client di gioco.

Per richiedere un'altra pagina, invia il nextCursor restituito come cursor, mantenendo invariati i filtri e limit. Un cursore null indica la fine. La ricerca supporta testo letterale, licenza e modello del braccio della skin; i parametri non riconosciuti o ripetuti restituiscono 400.

Limiti di accesso

Connessione e autorizzazione MCP →

Questa versione consente solo letture approvate della libreria pubblica. Le chiavi API non possono creare job, ottenere preventivi, consultare un wallet, caricare riferimenti, gestire chiavi o acquistare crediti. Le sessioni dell'account del sito gestiscono le chiavi separatamente. Gli strumenti MCP usano un'autorizzazione OAuth separata tramite il sito.