> For the complete documentation index, see [llms.txt](https://docs.mythmc.ovh/desarrolladores/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mythmc.ovh/desarrolladores/obtener-datos/usuarios.md).

# Usuarios

{% hint style="info" %}
Actualmente todas las peticiones utilizan como base la dirección <mark style="background-color:blue;"><https://api.mythmc.ovh/v1/>...</mark>\
Puedes ver todas las peticiones posibles haciendo [clic aquí](#lista-de-peticiones-posibles).
{% endhint %}

## Usar `curl` en la interfazUsar `curl` en la interfaz

1. **Instalar** [**curl**](https://curl.se/download.html) **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:&#x20;

```bash
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:

```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:

```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.&#x20;

{% openapi src="/files/PxPQSawe2WXPbmELgZDt" path="/users/{nombre}/{consulta}" method="get" %}
[openapi-2.json](https://4159945464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN9kKNdeG9wsaYlmP8R2%2Fuploads%2FtGhytFjPuWbgPlNqmEhn%2Fopenapi-2.json?alt=media\&token=84311d6a-4cc6-4d15-b7cd-51741c7d9891)
{% endopenapi %}

Las **{consultas}** posibles son:

{% openapi src="/files/PxPQSawe2WXPbmELgZDt" path="/users/{nombre}/mytharites" method="get" %}
[openapi-2.json](https://4159945464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN9kKNdeG9wsaYlmP8R2%2Fuploads%2FtGhytFjPuWbgPlNqmEhn%2Fopenapi-2.json?alt=media\&token=84311d6a-4cc6-4d15-b7cd-51741c7d9891)
{% endopenapi %}

{% openapi src="/files/PxPQSawe2WXPbmELgZDt" path="/users/{nombre}/clan" method="get" %}
[openapi-2.json](https://4159945464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN9kKNdeG9wsaYlmP8R2%2Fuploads%2FtGhytFjPuWbgPlNqmEhn%2Fopenapi-2.json?alt=media\&token=84311d6a-4cc6-4d15-b7cd-51741c7d9891)
{% endopenapi %}

{% openapi src="/files/PxPQSawe2WXPbmELgZDt" path="/users/{nombre}/kills\_deaths" method="get" %}
[openapi-2.json](https://4159945464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN9kKNdeG9wsaYlmP8R2%2Fuploads%2FtGhytFjPuWbgPlNqmEhn%2Fopenapi-2.json?alt=media\&token=84311d6a-4cc6-4d15-b7cd-51741c7d9891)
{% endopenapi %}

{% openapi src="/files/PxPQSawe2WXPbmELgZDt" path="/users/{nombre}/player\_info" method="get" %}
[openapi-2.json](https://4159945464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN9kKNdeG9wsaYlmP8R2%2Fuploads%2FtGhytFjPuWbgPlNqmEhn%2Fopenapi-2.json?alt=media\&token=84311d6a-4cc6-4d15-b7cd-51741c7d9891)
{% endopenapi %}

{% openapi src="/files/PxPQSawe2WXPbmELgZDt" path="/users/{nombre}/referral" method="get" %}
[openapi-2.json](https://4159945464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN9kKNdeG9wsaYlmP8R2%2Fuploads%2FtGhytFjPuWbgPlNqmEhn%2Fopenapi-2.json?alt=media\&token=84311d6a-4cc6-4d15-b7cd-51741c7d9891)
{% endopenapi %}

{% openapi src="/files/PxPQSawe2WXPbmELgZDt" path="/users/{nombre}/protocol" method="get" %}
[openapi-2.json](https://4159945464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdN9kKNdeG9wsaYlmP8R2%2Fuploads%2FtGhytFjPuWbgPlNqmEhn%2Fopenapi-2.json?alt=media\&token=84311d6a-4cc6-4d15-b7cd-51741c7d9891)
{% endopenapi %}