Especificação da API REST

Documentação de contratos dos serviços de atualização, sincronização de cosméticos de jogadores e telemetria.

Base URL: https://api.adscaramelo.site/site/api/

GET /api/updates/check.php Produção

Manifesto consumido pelo UpdateManager do mod Fabric (MC 26.2). Compatível com GitHubReleaseParser.parseAuto.

Exemplo cURL

curl -s "https://api.adscaramelo.site/site/api/updates/check.php?mc=26.2"

GET /api/updates/download.php

Streaming seguro do binário JAR com cabeçalho Content-Disposition: attachment e prevenção estrita contra Path Traversal (OWASP A01).

curl -O -L "https://api.adscaramelo.site/site/api/updates/download.php?version=1.0.5"

GET /api/players/sync.php CapeSyncManager Zero-Knowledge

Endpoint consumido pelo CapeSyncManager.parseAndMergeCapesJson() do mod Fabric para sincronização de cosméticos de jogadores e validação de whitelist Zero-Knowledge.

Exemplo cURL

curl -s "https://api.adscaramelo.site/site/api/players/sync.php"

Payload de Resposta (JSON)

{ "status": "success", "timestamp": 1794614400, "count": 2, "hashes": [ "c8922c2b3e8c187a55d78a9c34e76d91f24d77341e975b3b3a62888f7b7cb1d1", "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" ], "whitelist": [ "zYamaTheBest", "481409e0-a2c8-4982-aa76-601b5f77a6f3" ], "players": [ { "nickname": "zYamaTheBest", "uuid": "481409e0-a2c8-4982-aa76-601b5f77a6f3", "cape": "god_team", "gloves": "crimson", "pet": "nether_wyvern", "wings": "angel", "headwear": "crown", "dance": "floss", "whitelisted": true, "lastSeen": "2026-11-13 20:55:00" } ] }

GET /api/cosmetics/catalog.php

Catálogo com 46 cosméticos canônicos mapeados nos enums do mod Fabric (CapeType, GloveType, PetType, WingType, HeadwearType, DanceType).

curl -s "https://api.adscaramelo.site/site/api/cosmetics/catalog.php?category=capas"

POST /api/sync/telemetry.php

Recepção de heartbeat de clientes com sincronização automática do jogador no painel admin e checagem de versão.

curl -X POST "https://api.adscaramelo.site/site/api/sync/telemetry.php" \ -H "Content-Type: application/json" \ -d '{"nickname":"zYamaTheBest","uuid":"481409e0-a2c8-4982-aa76-601b5f77a6f3","version":"1.0.5","cape":"god_team"}'