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.

get

Consulta un dato específico.

Authorizations

BasicAuth

AuthorizationstringRequired

Path parameters

nombrestringRequired

El nombre del clan

consultastring · enumRequired

El dato a consultar

Possible values:

Responses

200

OK

No content

400

Petición inválida

401

Falta la clave

404

El usuario no existe

get

/users/{nombre}/{consulta}

HTTPcURLJavaScriptPython

GET /v1/users/{nombre}/{consulta} HTTP/1.1
Host: api.mythmc.ovh
Authorization: Basic username:password
Accept: */*

No content

Las {consultas} posibles son:

get

Consulta la cantidad de mitaritas de un usuario.

Authorizations

BasicAuth

AuthorizationstringRequired

Path parameters

nombrestringRequired

El nombre del usuario

Responses

200

OK

application/json

usernamestringOptional

El nombre de usuario.

amountintegerOptional

La cantidad de mitaritas del usuario.

400

Petición inválida

401

Falta la clave

404

El usuario no existe

get

/users/{nombre}/mytharites

HTTPcURLJavaScriptPython

GET /v1/users/{nombre}/mytharites HTTP/1.1
Host: api.mythmc.ovh
Authorization: Basic username:password
Accept: */*

{
  "username": "text",
  "amount": 1
}

get

Consulta el clan de un usuario.

Authorizations

BasicAuth

AuthorizationstringRequired

Path parameters

nombrestringRequired

El nombre del usuario

Responses

200

OK

application/json

clanstringOptional

El nombre del clan.

usernamestringOptional

El nombre de usuario.

400

Petición inválida

401

Falta la clave

404

El usuario no existe

get

/users/{nombre}/clan

HTTPcURLJavaScriptPython

GET /v1/users/{nombre}/clan HTTP/1.1
Host: api.mythmc.ovh
Authorization: Basic username:password
Accept: */*

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

get

Consulta los asesinatos y las muertes de un usuario.

Authorizations

BasicAuth

AuthorizationstringRequired

Path parameters

nombrestringRequired

El nombre del usuario

Responses

200

OK

application/json

usernamestringOptional

El nombre de usuario.

killsintegerOptional

La cantidad de asesinatos del usuario.

deathsintegerOptional

La cantidad de muertes del usuario.

400

Petición inválida

401

Falta la clave

404

El usuario no existe

get

/users/{nombre}/kills_deaths

HTTPcURLJavaScriptPython

GET /v1/users/{nombre}/kills_deaths HTTP/1.1
Host: api.mythmc.ovh
Authorization: Basic username:password
Accept: */*

{
  "username": "text",
  "kills": 1,
  "deaths": 1
}

get

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

Authorizations

BasicAuth

AuthorizationstringRequired

Path parameters

nombrestringRequired

El nombre del usuario

Responses

200

OK

application/json

usernamestringOptional

El nombre de usuario.

firstJoinstringOptional

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

lastJoinstringOptional

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

playTimeintegerOptional

El tiempo total de juego del usuario en segundos.

redeemablePlayTimeintegerOptional

El tiempo de juego del usuario recompensable en segundos.

400

Petición inválida

401

Falta la clave

404

El usuario no existe

get

/users/{nombre}/player_info

HTTPcURLJavaScriptPython

GET /v1/users/{nombre}/player_info HTTP/1.1
Host: api.mythmc.ovh
Authorization: Basic username:password
Accept: */*

{
  "username": "text",
  "firstJoin": "text",
  "lastJoin": "text",
  "playTime": 1,
  "redeemablePlayTime": 1
}

get

Consulta el anfitrión de un usuario.

Authorizations

BasicAuth

AuthorizationstringRequired

Path parameters

nombrestringRequired

El nombre del usuario

Responses

200

OK

application/json

usernamestringOptional

El nombre de usuario.

referralstringOptional

El anfitrión del usuario.

400

Petición inválida

401

Falta la clave

404

El usuario no existe

get

/users/{nombre}/referral

HTTPcURLJavaScriptPython

GET /v1/users/{nombre}/referral HTTP/1.1
Host: api.mythmc.ovh
Authorization: Basic username:password
Accept: */*

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

get

Consulta el último protocolo utilizado por un usuario.

Authorizations

BasicAuth

AuthorizationstringRequired

Path parameters

nombrestringRequired

El nombre del usuario

Responses

200

OK

application/json

usernamestringOptional

El nombre de usuario.

protocolintegerOptional

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

400

Petición inválida

401

Falta la clave

404

El usuario no existe

get

/users/{nombre}/protocol

HTTPcURLJavaScriptPython

GET /v1/users/{nombre}/protocol HTTP/1.1
Host: api.mythmc.ovh
Authorization: Basic username:password
Accept: */*

{
  "username": "text",
  "protocol": 1
}