Usuarios

Información básica para obtener datos de usuarios.

Actualmente todas las peticiones utilizan como base la dirección https://api.mythmc.ovh/v1/... Puedes ver todas las peticiones posibles haciendo clic aquí.

Usar curl en la interfazUsar curl en la interfaz

1. Instalar curl si no está instalado aún en tu ordenador. Puedes comprobarlo rápidamente desde la terminal de tu sistema operativo con el comando curl --version.

2. Crear una clave de acceso si aún no tienes una. Para ello, ve al servidor e introduce el comando /api key. Puedes consultar esta llave en cualquier momento usando el comando /api key list.

3. Ejecutar una consulta de prueba. Abre la terminal de tu sistema operativo y ejecuta cualquier petición especificando tu clave de acceso como header (mira el comando de abajo si no sabes cómo hacerlo). Si la petición se ejecuta correctamente obtendrás el código 200 junto a la respuesta.

Ejemplo:

curl -H "X-API-Key: clave-de-acceso" "https://api.mythmc.ovh/v1/users/test/mytharites

Incorporar el ejemplo en una IDE

Una vez hayamos comprobado que la conexión con la API es correcta y estable ya solo es cuestión de encontrar la forma de incorporar llamadas a una API REST usando tu lenguaje de programación de elección.

Por ejemplo, para el caso de Java:

class call {
	public static void main(String[] args) {
		HttpRequest request = HttpRequest.newBuilder()
				.uri(URI.create("https://api.mythmc.ovh/v1/users/Udeilu/mytharites"))
				.header("X-API-Key", "tu-clave")
				.method("GET", HttpRequest.BodyPublishers.noBody())
				.build();
		// Faltaría guardar la respuesta
	}
}

O, si usamos JavaScript:

fetch('https://api.mythmc.ovh/v1/users/Udeilu/mytharites', {
      method: 'GET',
      headers: {
            'X-API-Key': 'tu-clave',
            },
      })
      .then(response => response.json())
      .then(json => console.log(json));

En Google encontrarás muchos más ejemplos de cómo integrar una API usando cualquier lenguaje de programación que se te ocurra.

Lista de peticiones posibles

Estas son todas las peticiones relacionadas con los clanes que puedes integrar.

Consulta un dato específico.

GEThttps://api.mythmc.ovh/v1/users/{nombre}/{consulta}

Path parameters

nombre*string

El nombre del clan

consulta*enum

El dato a consultar

mytharitesclankills_deathsplayer_inforeferralprotocol

Response

200400401404

OK

Request

JavaScriptCurlPython

const response = await fetch('https://api.mythmc.ovh/v1/users/{nombre}/{consulta}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Las {consultas} posibles son:

Consulta la cantidad de mitaritas de un usuario.

GEThttps://api.mythmc.ovh/v1/users/{nombre}/mytharites

Path parameters

nombre*string

El nombre del usuario

Response

200400401404

OK

Body

application/json

usernamestring

El nombre de usuario.

amountinteger

La cantidad de mitaritas del usuario.

Request

JavaScriptCurlPython

const response = await fetch('https://api.mythmc.ovh/v1/users/{nombre}/mytharites', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "username": "text"
}

Consulta el clan de un usuario.

GEThttps://api.mythmc.ovh/v1/users/{nombre}/clan

Path parameters

nombre*string

El nombre del usuario

Response

200400401404

OK

Body

application/json

clanstring

El nombre del clan.

usernamestring

El nombre de usuario.

Request

JavaScriptCurlPython

const response = await fetch('https://api.mythmc.ovh/v1/users/{nombre}/clan', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "clan": "text",
  "username": "text"
}

Consulta los asesinatos y las muertes de un usuario.

GEThttps://api.mythmc.ovh/v1/users/{nombre}/kills_deaths

Path parameters

nombre*string

El nombre del usuario

Response

200400401404

OK

Body

application/json

usernamestring

El nombre de usuario.

killsinteger

La cantidad de asesinatos del usuario.

deathsinteger

La cantidad de muertes del usuario.

Request

JavaScriptCurlPython

const response = await fetch('https://api.mythmc.ovh/v1/users/{nombre}/kills_deaths', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "username": "text"
}

Consulta la información básica de un usuario.

GEThttps://api.mythmc.ovh/v1/users/{nombre}/player_info

Path parameters

nombre*string

El nombre del usuario

Response

200400401404

OK

Body

application/json

usernamestring

El nombre de usuario.

firstJoinstring

La fecha en la que entró el usuario por primera vez.

lastJoinstring

La fecha en la que entró el usuario por última vez.

playTimeinteger

El tiempo total de juego del usuario en segundos.

redeemablePlayTimeinteger

El tiempo de juego del usuario recompensable en segundos.

Request

JavaScriptCurlPython

const response = await fetch('https://api.mythmc.ovh/v1/users/{nombre}/player_info', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "username": "text",
  "firstJoin": "text",
  "lastJoin": "text"
}

Consulta el anfitrión de un usuario.

GEThttps://api.mythmc.ovh/v1/users/{nombre}/referral

Path parameters

nombre*string

El nombre del usuario

Response

200400401404

OK

Body

application/json

usernamestring

El nombre de usuario.

referralstring

El anfitrión del usuario.

Request

JavaScriptCurlPython

const response = await fetch('https://api.mythmc.ovh/v1/users/{nombre}/referral', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "username": "text",
  "referral": "text"
}

Consulta el último protocolo utilizado por un usuario.

GEThttps://api.mythmc.ovh/v1/users/{nombre}/protocol

Path parameters

nombre*string

El nombre del usuario

Response

200400401404

OK

Body

application/json

usernamestring

El nombre de usuario.

protocolinteger

El último protocolo con el que ingresó el usuario al servidor.

Request

JavaScriptCurlPython

const response = await fetch('https://api.mythmc.ovh/v1/users/{nombre}/protocol', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "username": "text"
}