MCSKINGEN

Bouw met de openbare bibliotheek

Lees originele skins, bloktexturen en bouwblauwdrukken via een API met versiebeheer, met expliciete bronnen, licenties en intrekbare sleutels.

Goedgekeurd werk, met de bron

Zoek skins, texturepacks en bouwblauwdrukken, lees hun licenties en naamsvermeldingen en download vervolgens de exacte gegenereerde bestanden. Privéprojecten, onbewerkte afbeeldingen, prompts en taken vallen buiten deze API.

OpenAPI 3.1-contract downloaden

API v1 · contract 1.1.0 · bereik library:read

Voorspelbare aanvraagquota

Elke sleutel staat 60 aanvragen per minuut en 5000 per UTC-dag toe. Deze aanvragen verbruiken geen generatiecredits. Lees het resterende quotum in de responsheaders; houd je bij 429 aan Retry-After.

Gebruik ETag en If-None-Match voor caching. Bij hervalidatie worden de sleutel en de huidige publicatiestatus gecontroleerd voordat 304 wordt geretourneerd. Ingetrokken inhoud retourneert 404; ingetrokken of verlopen sleutels retourneren 401.

Een alleen-lezen-sleutel maken

Opvragen, bekijken, downloaden

Bewaar je sleutel in een vertrouwd serverconfiguratiebestand. Verstuur deze als Authorization-header. Behoud sourceUrl, author, license en overgenomen naamsvermeldingen wanneer je een werk weergeeft of verder verspreidt. Niet-commerciële licenties blijven niet-commercieel.

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

# 2. Lees een publicatie aan de hand van de geretourneerde id
curl 'https://mcskingen.com/api/v1/library/skins/PUBLICATION_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY'

# 3. Download een van de geretourneerde bestanden
curl 'https://mcskingen.com/api/v1/assets/ASSET_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY' \
  --output original-skin.png

Gebruik /library/buildings?category=houses voor bouwwerken. Voxel-JSON en materiaal-CSV staan los van spelbestanden, die pas verschijnen nadat ze de vrijgavecontroles hebben doorstaan.

Gebruik voor blokresourcepacks /library/textures en de geretourneerde download-URL's. Elk bestand behoudt de beoogde spelversie; bestandscontroles garanderen niet dat import in de spelclient werkt.

Stuur voor een volgende pagina de geretourneerde nextCursor als cursor mee, met ongewijzigde filters en limit. Een null-cursor markeert het einde. Zoeken ondersteunt letterlijke tekst, licentie en het armmodel van de skin; onbekende of herhaalde parameters retourneren 400.

Toegangsgrenzen

MCP-verbinding en autorisatie →

Deze versie biedt uitsluitend leestoegang tot goedgekeurde inhoud in de openbare bibliotheek. API-sleutels kunnen geen taken aanmaken, prijsopgaven opvragen, een wallet uitlezen, referenties uploaden, sleutels beheren of credits kopen. Websiteaccountsessies beheren sleutels afzonderlijk. MCP-tools gebruiken afzonderlijke OAuth-autorisatie via de website.