v1.0 • REST API

API REST Pública de Minerva

API gratuita, abierta y en tiempo real para bots de Discord, aplicaciones web y herramientas de Fallout 76.

URL Basehttps://whereisminerva.info
CORSHabilitado (*)
FormatoJSON (UTF-8)
🔑

Tu Clave de API Personal

Utiliza tu clave en la cabecera x-api-key o como parámetro ?api_key= para identificar tus bots y herramientas.

¿Creando un bot de Discord o herramienta?

Inicia sesión o crea una cuenta gratis en 30 segundos para obtener tu API Key personal instantánea, monitorizar tus peticiones y garantizar acceso ilimitado.

🛡️ Autenticación y Cabeceras

Cómo autenticar tus llamadas a la API desde tus bots, aplicaciones web o scripts.

Cabecera HTTP (Recomendado)RECOMENDADO

Envía tu clave personal en la cabecera estándar x-api-key.

x-api-key: minerva_live_...
Bearer TokenRFC 6750

Soporte estándar para cabeceras de autorización HTTP Bearer.

Authorization: Bearer minerva_live_...
Parámetro URL (Query)URL PARAM

Útil para pruebas rápidas en navegador, cURL o webhooks simples.

?api_key=minerva_live_...
⏳Periodo de Transición y Límite sin Clave

Las llamadas sin clave están limitadas a 2 consultas por hora. Registra tu clave gratuita para acceso completo o escribe a bitman.online@gmail.com para coordinar.

⚡Límites y Política de Uso Justo (Fair Use)

Acceso libre sin coste ni límite estricto de peticiones. Recomendamos aplicar una caché local de 60 segundos en tus bots para un rendimiento óptimo.

GET

/api/v1/minerva

Estado y Stock

Devuelve el estado en tiempo real de Minerva en Fallout 76: si está presente, su ubicación exacta en Appalachia, fechas UTC y Unix de llegada/salida, inventario y próxima visita.

Parámetros

NombreEnTipoRequeridoDescripción
x-api-keyheaderstringOpcional (Recomendado)Clave de API personal (minerva_live_...). Identifica tus peticiones y garantiza acceso ininterrumpido.

Probar Endpoint

⚠️ Sin Clave (Gracia)
GEThttps://whereisminerva.info/api/v1/minerva

Ejemplos de Código

curl -X GET "https://whereisminerva.info/api/v1/minerva" \
  -H "x-api-key: minerva_live_YOUR_KEY" \
  -H "Accept: application/json"
🤖

¿Creando un Bot de Discord?

API en tiempo real con soporte CORS y autenticación mediante API Key gratuita. Utiliza marcas de tiempo Unix en segundos (startsAtUnix, endsAtUnix) para cuentas atrás automáticas en Discord. (<t:TIMESTAMP:R>).

// Slash Command: /minerva (Discord.js v14)
import { SlashCommandBuilder, EmbedBuilder } from 'discord.js';

export const data = new SlashCommandBuilder()
  .setName('minerva')
  .setDescription('Check Minerva live location, countdown, and stock in Fallout 76');

export async function execute(interaction) {
  const res = await fetch('https://whereisminerva.info/api/v1/minerva', {
    headers: { 'x-api-key': 'minerva_live_YOUR_KEY' }
  });
  const { data } = await res.json();

  const embed = new EmbedBuilder()
    .setTitle(data.isActive ? `Minerva is at ${data.location.nameEn}!` : 'Minerva is currently away')
    .setColor(data.isActive ? 0x8ba358 : 0x555555);

  if (data.isActive) {
    embed
      .setDescription(`📍 **Location:** ${data.location.nameEn} (${data.location.coordinates})\n⏳ **Leaves:** <t:${data.endsAtUnix}:R> (<t:${data.endsAtUnix}:f>)`)
      .setImage(data.location.imageUrl)
      .addFields({
        name: `Featured Plans (${data.inventory.totalItems} total)`,
        value: data.inventory.preview.map(i => `• **${i.name}** — ${i.priceGold} Gold`).join('\n') || 'None'
      });
  } else if (data.nextVisit) {
    embed.setDescription(`📍 **Next Visit:** ${data.nextVisit.location.nameEn}\n⏳ **Arrives:** <t:${data.nextVisit.startsAtUnix}:R> (<t:${data.nextVisit.startsAtUnix}:f>)`);
  }

  await interaction.reply({ embeds: [embed] });
}