MCSKINGEN

Desenvolva com a biblioteca pública

Consulte skins originais, texturas de blocos e projetos de construções por meio de uma API versionada, com fontes e licenças explícitas e chaves revogáveis.

Obras aprovadas, com suas fontes

Pesquise skins, pacotes de texturas e projetos de construções, consulte suas licenças e atribuições e baixe os arquivos exatos gerados. Projetos privados, imagens brutas, prompts e tarefas ficam fora desta API.

Baixar contrato OpenAPI 3.1

API v1 · contrato 1.1.0 · escopo library:read

Cotas de requisições previsíveis

Cada chave permite 60 requisições por minuto e 5000 por dia UTC. Essas requisições não consomem créditos de geração. Consulte a cota restante nos cabeçalhos de resposta; respeite Retry-After em respostas 429.

Use cache com ETag e If-None-Match. A revalidação verifica a chave e o estado atual de publicação antes de retornar 304. Conteúdos retirados retornam 404; chaves revogadas ou expiradas retornam 401.

Criar uma chave somente de leitura

Entre com sua conta do site para criar, inspecionar e revogar suas chaves de integração.

Consulte, inspecione e baixe

Mantenha sua chave em um arquivo de configuração de servidor confiável. Envie-a no cabeçalho Authorization. Preserve sourceUrl, author, license e as atribuições herdadas ao exibir ou redistribuir uma obra. Licenças não comerciais continuam sendo não comerciais.

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

# 2. Ler uma publicação usando o ID retornado
curl 'https://mcskingen.com/api/v1/library/skins/PUBLICATION_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY'

# 3. Baixar um dos recursos retornados
curl 'https://mcskingen.com/api/v1/assets/ASSET_ID' \
  -H 'Authorization: Bearer YOUR_READ_ONLY_KEY' \
  --output original-skin.png

Para estruturas de construções, use /library/buildings?category=houses. O JSON de voxels e o CSV de materiais são separados dos arquivos de jogo, que só aparecem após serem aprovados nas verificações de liberação.

Para pacotes de recursos de blocos, use /library/textures e as URLs de download retornadas. Cada arquivo mantém sua versão de destino do jogo; as verificações de arquivos não certificam a importação no cliente do jogo.

Para obter outra página, envie o nextCursor retornado como cursor, sem alterar os filtros e limit. Um cursor null indica o fim. A busca aceita texto literal, licença e modelo de braços da skin; parâmetros não reconhecidos ou repetidos retornam 400.

Limites de acesso

Conexão e autorização MCP →

Esta versão disponibiliza apenas consultas à biblioteca pública aprovada. As chaves de API não podem criar tarefas, obter cotações, consultar uma carteira, enviar referências, gerenciar chaves ou comprar créditos. As sessões de conta do site gerenciam as chaves separadamente. As ferramentas MCP usam uma autorização OAuth separada no site.