Documentación del API

Integra el estado de servidores de Minecraft Java y Bedrock en tus propias aplicaciones, bots de Discord o sitios web con nuestra API pública y gratuita.

Rápida y Sin Caché

Obtén el estado en tiempo real. Consultamos directamente al servidor en cada petición para garantizar datos frescos.

Multi-Edición

Soporte completo para servidores Minecraft Java Edition y Bedrock Edition en un mismo endpoint unificado.

99.9% Uptime

Infraestructura robusta diseñada para alta disponibilidad y baja latencia desde múltiples ubicaciones.

Endpoint Principal

GEThttps://api.bettersrv.lat/services/mcstatus/{edition}/{ip}

Parámetros

editionRequerido

La edición del servidor de Minecraft.

javabedrock
ipRequerido

La dirección IP o dominio del servidor. Puede incluir el puerto (ej: mc.hypixel.net o play.example.com:25565).

Ejemplo de Uso

fetch-status.ts
const fetchStatus = async () => {
  const res = await fetch(
    "https://api.bettersrv.lat/services/mcstatus/java/mc.hypixel.net"
  );
  
  const data = await res.json();
  
  if (data.online) {
    console.log(`Jugadores: ${data.players.online}`);
  }
};

Estructura de Respuesta

interface ServerData {
  online: boolean;          // Estado del servidor
  edition: "java" | "bedrock"; 
  host: string;             // Host consultado
  ip: string;               // IP resuelta
  port: number;             // Puerto del servidor
  
  // Solo si online: true
  version?: {
    name: string;           // Nombre de la versión (ej: "1.20.4")
    protocol: number;       // Versión del protocolo
  };
  players?: {
    online: number;         // Jugadores conectados
    max: number;            // Capacidad máxima
    sample: Array<{         // Lista de jugadores (si disponible)
      name: string;
      id: string;
    }>;
  };
  motd?: {
    html: string;           // MOTD formateado en HTML
    clean: string;          // MOTD en texto plano
  };
  favicon?: string;         // Icono en base64 (Solo Java)
  latency?: number;         // Ping en milisegundos
  
  // Solo si ocurre un error
  error?: string;
}