Usuarios
Información básica para obtener datos de usuarios.
Usar curl en la interfazUsar curl en la interfaz
curl en la interfazUsar curl en la interfazInstalar 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.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.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/mytharitesIncorporar 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.
El nombre del clan
El dato a consultar
GET /v1/users/{nombre}/{consulta} HTTP/1.1
Host: api.mythmc.ovh
Authorization: Basic username:password
Accept: */*
No content
Las {consultas} posibles son:
Consulta la cantidad de mitaritas de un usuario.
El nombre del usuario
GET /v1/users/{nombre}/mytharites HTTP/1.1
Host: api.mythmc.ovh
Authorization: Basic username:password
Accept: */*
{
"username": "text",
"amount": 1
}Consulta el clan de un usuario.
El nombre del usuario
GET /v1/users/{nombre}/clan HTTP/1.1
Host: api.mythmc.ovh
Authorization: Basic username:password
Accept: */*
{
"clan": "text",
"username": "text"
}Consulta los asesinatos y las muertes de un usuario.
El nombre del usuario
GET /v1/users/{nombre}/kills_deaths HTTP/1.1
Host: api.mythmc.ovh
Authorization: Basic username:password
Accept: */*
{
"username": "text",
"kills": 1,
"deaths": 1
}Consulta la información básica de un usuario.
El nombre del usuario
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
}Consulta el anfitrión de un usuario.
El nombre del usuario
GET /v1/users/{nombre}/referral HTTP/1.1
Host: api.mythmc.ovh
Authorization: Basic username:password
Accept: */*
{
"username": "text",
"referral": "text"
}Consulta el último protocolo utilizado por un usuario.
El nombre del usuario
GET /v1/users/{nombre}/protocol HTTP/1.1
Host: api.mythmc.ovh
Authorization: Basic username:password
Accept: */*
{
"username": "text",
"protocol": 1
}Last updated