API REST Pública de Minerva
API gratuita, abierta y en tiempo real para bots de Discord, aplicaciones web y herramientas de Fallout 76.
https://whereisminerva.infoTu 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.
Envía tu clave personal en la cabecera estándar x-api-key.
x-api-key: minerva_live_...Soporte estándar para cabeceras de autorización HTTP Bearer.
Authorization: Bearer minerva_live_...Útil para pruebas rápidas en navegador, cURL o webhooks simples.
?api_key=minerva_live_...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.
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.
/api/v1/minerva
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
| Nombre | En | Tipo | Requerido | Descripción |
|---|---|---|---|---|
x-api-key | header | string | Opcional (Recomendado) | Clave de API personal (minerva_live_...). Identifica tus peticiones y garantiza acceso ininterrumpido. |
Probar Endpoint
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] });
}