Minecraft Server Status

Parâmetros

Resposta

Exemplo de resposta real

{
		"success": true,
		"data": {
			 "online": true,
			 "ip": "hypixel.net",
			 "port": 25565,
			 "version": "1.20.4",
			 "software": "Paper",
			 "players": {"online": 45000, "max": 100000}
		}
}

# Minecraft Server Status

`GET https://api.nyqo.dev/api/v1/games/minecraft/status`

Verifica o status de um servidor Minecraft incluindo se está online, número de jogadores, versão e software. Perfeito para verificar disponibilidade de servidores antes de conectar.

Categoria: Jogos · Slug: `minecraft-status`

## Autenticação

```http
Authorization: Bearer nyq_sua_chave_aqui
```

Também aceito: `X-API-Key: nyq_sua_chave_aqui`. Nunca via query string (`?api_key`).

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `address` | `string` | sim | Endereço do servidor (ex: hypixel.net, play.hypixel.net) |

## Resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `online` | `boolean` | Indica se o servidor está online |
| `ip` | `string` | Endereço IP do servidor |
| `port` | `integer` | Porta do servidor (geralmente 25565) |
| `version` | `string` | Versão do Minecraft suportada |
| `software` | `string` | Software do servidor (Spigot, Paper, Fabric, etc) |
| `players` | `object` | Informações de jogadores: online e max |

## Exemplo (curl)

```bash
curl "https://api.nyqo.dev/api/v1/games/minecraft/status?address=hypixel.net" \n  -H "Authorization: Bearer nyq_sua_chave_aqui"
```

## Exemplo de resposta

```json
{
		"success": true,
		"data": {
			 "online": true,
			 "ip": "hypixel.net",
			 "port": 25565,
			 "version": "1.20.4",
			 "software": "Paper",
			 "players": {"online": 45000, "max": 100000}
		}
}
```

Erros comuns

• · 401 unauthorized — sem chave ou chave inválida. Confira autenticação.
• · 403 forbidden — plano sem esta rota ou chave fora do escopo. Veja planos.
• · 429 rate_limited — quota estourada; aguarde Retry-After. Detalhes em rate limits.

Tabela completa em /docs — códigos de erro.