Documentación de la API de hosting de Minecraft
Una visión general de la API alpha de Ametistos usada por el panel web para autenticación, servidores, jugadores, archivos, acceso, notificaciones y datos de cuenta.
Estado de la API de Ametistos durante la alpha
La aplicación se comunica con la API versionada de Ametistos en https://api.ametistos.com/api/v1.
El contrato aún está evolucionando durante la alpha, así que las integraciones deben gestionar errores
de validación, funciones no disponibles y cambios en las respuestas. No expongas los tokens de acceso en
registros del navegador ni en repositorios públicos.
Endpoints de autenticación y cuenta
POST /auth/email/resend— reenviar un código de confirmación por correo.POST /auth/email/confirm— confirmar una cuenta con el código recibido.POST /auth/password/forgot— solicitar un código de restablecimiento de contraseña.POST /auth/password/reset— verificar el código y establecer una nueva contraseña.GET /auth/google— iniciar la autenticación con Google.PATCH /users/password— actualizar la contraseña del usuario autenticado.
Operaciones de servidor y jugador de Minecraft
Las rutas de servidor autenticadas exponen la creación y configuración, el estado de ejecución, los
comandos de consola, los archivos, el software, las extensiones y la información de jugadores. Las
estadísticas de jugadores están disponibles en /servers/players/stats/:serverId. Los
comandos de moderación tipo consola se envían mediante /servers/command/:serverIdcon una
carga JSON.
Notificaciones, acceso y códigos promocionales
El panel de control lee las notificaciones de la cuenta desde /notifications/me. Las rutas
de acceso al servidor listan a los colaboradores y modifican sus permisos limitados. Las rutas de
códigos promocionales activan un código y devuelven las promociones y beneficios usados previamente por
el usuario autenticado.
Requisitos de integración de la API
- Envía el token de portador actual solo al origen configurado de la API de Ametistos.
- Comprueba que hay un token válido antes de cargar rutas protegidas de cuenta o servidor.
- Gestiona explícitamente las respuestas 401, 403, 404, de validación y de compatibilidad.
- Invalida los datos de servidor en caché tras mutaciones como subidas, comandos o reseteos.
- Obtén estadísticas del contenedor solo mientras el estado del servidor de Minecraft esté en línea.