Receitas prontas

Guias de integração

Projetos reais montados com a Nebula API em poucos minutos. Copie o código, troque o endereço e pronto.

Início Rápido Developer Hub
Minecraft Discord

Anunciar status do servidor no Discord

Poste em um webhook do seu servidor uma mensagem com o banner de status do servidor de Minecraft. Combine com um agendador (cron, GitHub Actions ou o agendador do seu bot) e rode a cada 5 minutos — a resposta é cacheada, então chamar com essa frequência é barato. 

curl -X POST "https://discord.com/api/webhooks/SEU_ID/SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Status do servidor agora:",
    "embeds": [{
      "title": "mc.hypixel.net",
      "image": {"url": "https://nebula.starsstudio.xyz/api/minecraft/server/java/mc.hypixel.net/widget?theme=dark&rounded=true"}
    }]
  }'

O SEU_ID/SEU_TOKEN vêm da sua própria integração de webhook no Discord (Configurações do canal → Integrações).

Minecraft

Avatar de jogador em ranking ou perfil

Grid de jogadores, tabela de ranking ou lista de membros do clã: cada face de skin é uma URL só, sem biblioteca de render no seu servidor. 

<img src="https://nebula.starsstudio.xyz/api/minecraft/render/head/Notch/face" alt="Notch" width="64">
<img src="https://nebula.starsstudio.xyz/api/minecraft/render/head/jeb_/face" alt="jeb_" width="64">

Variações: head/full (cabeça 3D), body/full (corpo inteiro) e skin (textura original). Skin custom: ?skinUrl=https://textures.minecraft.net/.... Teste no Skin Lab →

Roblox Discord

Headshot de avatar Roblox em embed

Embeds do Discord rejeitam rbxthumb:// e links com muitos redirecionamentos. O proxy da Nebula entrega o PNG direto, pronto para usar como thumbnail. 

curl -X POST "https://discord.com/api/webhooks/SEU_ID/SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "embeds": [{
      "title": "Perfil do jogador",
      "thumbnail": {"url": "https://nebula.starsstudio.xyz/api/roblox/avatar-headshot/1"}
    }]
  }'

Vitrine de jogos também existe: https://nebula.starsstudio.xyz/api/roblox/games?ids=2753915549 devolve nome, ícone, jogadores online e % de curtidas.

💡

Todos os endpoints são GET (exceto composição) e não exigem chave. Confira limites e cache na página de limites.