Documentação Pixel Host

Pixel Market

Consulte, publique e instale recursos do marketplace oficial da Pixel Host.

Consultas, busca, perfis, coleções e downloads do Pixel Market são públicos e não exigem API Key. Publicação, avaliações, denúncias, coleções mutáveis e instalação exigem sessão Pixel Host com CSRF ou token Bearer com o escopo correspondente.

Uploads de até 2 GB usam sessões retomáveis. Crie o projeto, abra uma versão, envie partes de até 16 MB em ordem e finalize a sessão. O artefato permanece em quarentena até o worker concluir integridade, traversal, executáveis, segredos, bomba de descompressão e antivírus.

Versões também podem apontar para um link HTTPS direto do arquivo compilado. Nesse modo, o limite padrão é 4 GB, o worker baixa uma cópia temporária para análise, salva SHA-256 e metadados de revalidação, mas o download público redireciona para a origem aprovada. Se ETag, Last-Modified ou tamanho mudarem, a versão sai do ar e volta automaticamente para a fila de segurança.

A instalação inteligente retorna primeiro um plano com compatibilidade, dependências, ações, bloqueios e necessidade de backup. Incompatibilidade declarada pode ser aceita explicitamente; instância ligada, dependência obrigatória ausente e alteração destrutiva sem confirmação continuam bloqueadas.

Plugins e mods instalados pelo Pixel Market ativam atualização automática por padrão. Quando uma atualização exige parada, backup ou confirmação destrutiva, o painel informa a nova versão em vez de alterar a instância silenciosamente.

Categorias extensíveis: plugins, mods, modpacks, builds, mundos, servidores configurados, templates, resource packs e shaders
Downloads incluem SHA-256 e objetos publicados são imutáveis
Links externos precisam usar HTTPS público e enviar ETag ou Last-Modified para detecção segura de mudanças
Pixel Verified é concedido e removido automaticamente por reputação, qualidade, estabilidade e confiança
Dependências podem ser obrigatórias, recomendadas ou opcionais e podem cruzar categorias
Nunca execute artefatos durante a análise; processe somente em quarentena

Exemplo

curl -sS "https://pixel-host.com.br/api/v1/market/projects?category=plugins&minecraftVersion=1.21.4&sort=downloads"

Endpoints

GET/market/projects

Busca projetos com filtros de categoria, loader, versão, licença, selo e ordenação.

Permissão: public

Como enviar

curl -sS -X GET \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  "https://pixel-host.com.br/api/v1/market/projects?q=worldedit&category=plugins&sort=downloads"

Resposta HTTP 200

{ "total": 1, "items": [{ "slug": "worldedit", "category": "plugins", "verified": true }] }

GET/market/projects/{slug}

Retorna detalhes, versões aprovadas e avaliações de um projeto.

Permissão: public

Como enviar

curl -sS -X GET \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  "https://pixel-host.com.br/api/v1/market/projects/{slug}"

GET/market/projects/{slug}/download/{versionId}

Baixa um artefato aprovado ou redireciona para a origem externa aprovada após revalidar os metadados de segurança.

Permissão: public

Como enviar

curl -sS -X GET \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  "https://pixel-host.com.br/api/v1/market/projects/{slug}/download/{versionId}"

GET/market/creators/{slug}

Retorna perfil, estatísticas e projetos publicados por um criador.

Permissão: public

Como enviar

curl -sS -X GET \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  "https://pixel-host.com.br/api/v1/market/creators/{slug}"

GET/market/collections/{slug}

Retorna uma coleção pública e seus projetos.

Permissão: public

Como enviar

curl -sS -X GET \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  "https://pixel-host.com.br/api/v1/market/collections/{slug}"

GET/market/stats

Retorna estatísticas públicas agregadas da plataforma.

Permissão: public

Como enviar

curl -sS -X GET \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  "https://pixel-host.com.br/api/v1/market/stats"

POST/market/projects

Cria um projeto em rascunho. Exige conta Pixel Host com Discord vinculado.

Permissão: market.publish

Como enviar

curl -sS -X POST \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{ "name": "Meu Plugin", "category": "plugins", "summary": "Resumo público do projeto", "description": "Descrição completa do projeto e de seus recursos.", "licenseId": "mit" }' \
  "https://pixel-host.com.br/api/v1/market/projects"

Corpo JSON formatado

{ "name": "Meu Plugin", "category": "plugins", "summary": "Resumo público do projeto", "description": "Descrição completa do projeto e de seus recursos.", "licenseId": "mit" }

POST/market/projects/{slug}/versions

Cria uma versão por upload retomável ou por link HTTPS externo revalidável.

Permissão: market.publish

Como enviar

curl -sS -X POST \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{ "version": "1.0.0", "sourceType": "external", "externalUrl": "https://example.com/releases/meu-plugin.jar", "minecraftVersions": ["1.21.4"], "loaders": ["paper"] }' \
  "https://pixel-host.com.br/api/v1/market/projects/{slug}/versions"

Corpo JSON formatado

{ "version": "1.0.0", "sourceType": "external", "externalUrl": "https://example.com/releases/meu-plugin.jar", "minecraftVersions": ["1.21.4"], "loaders": ["paper"] }

POST/market/uploads/{uploadId}/complete

Finaliza o upload e coloca o artefato na fila de análise.

Permissão: market.publish

Como enviar

curl -sS -X POST \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  "https://pixel-host.com.br/api/v1/market/uploads/{uploadId}/complete"

POST/market/projects/{slug}/reviews

Publica nota e comentário. Uma avaliação por conta e projeto.

Permissão: market.interact

Como enviar

curl -sS -X POST \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{ "rating": 5, "comment": "Funcionou bem na versão indicada." }' \
  "https://pixel-host.com.br/api/v1/market/projects/{slug}/reviews"

Corpo JSON formatado

{ "rating": 5, "comment": "Funcionou bem na versão indicada." }

POST/market/projects/{slug}/reports

Abre uma denúncia com motivo, descrição e evidências opcionais.

Permissão: market.interact

Como enviar

curl -sS -X POST \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{ "reason": "malware", "details": "Descreva o comportamento e como foi observado." }' \
  "https://pixel-host.com.br/api/v1/market/projects/{slug}/reports"

Corpo JSON formatado

{ "reason": "malware", "details": "Descreva o comportamento e como foi observado." }

POST/market/projects/{slug}/install-plan

Simula compatibilidade, dependências, ações e bloqueios antes da instalação.

Permissão: public

Como enviar

curl -sS -X POST \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{ "serverId": "SERVER_ID", "versionId": "VERSION_ID" }' \
  "https://pixel-host.com.br/api/v1/market/projects/{slug}/install-plan"

Corpo JSON formatado

{ "serverId": "SERVER_ID", "versionId": "VERSION_ID" }

API basehttps://pixel-host.com.br/api/v1