> For the complete documentation index, see [llms.txt](https://leenh.gitbook.io/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://leenh.gitbook.io/api-docs/inicio-rapido.md).

# Inicio Rapido

## Obtener Token

Para hacer uso de la API necesitara darse de alta, para ello necesitara un usuario, una contraseña y una palabra clave, ante esto el sistema responderá con la creación de un token de acceso.

#### Consideraciones

* El usuario debe tener minimo 6 caracteres, sin espacios o emplear el uso de "\_".
* Su contraseña debe tener minimo 6 caracteres, debe tener una combinación de letras en minúsculas y mayúsculas además de contener almenos un número.
* La palabra clave debe minimo 6 caracteres, sin espacios o emplear el uso de "\_".
* La palabra clave debe ser única y no debe de compartirla con nadie, al igual que su usuario y su contraseña.

Para crear el token debe hacer una petición GET.

## Alta de Usuario

<mark style="color:blue;">`GET`</mark> `https://leenhcraft.com/api/auth?user=insomnia&pass=contrasenia&key=palabra`

Creacion de usuario y token para futuras peticiones

#### Query Parameters

| Name                                   | Type   | Description                   |
| -------------------------------------- | ------ | ----------------------------- |
| user<mark style="color:red;">\*</mark> | String | nombre de usuario             |
| pass<mark style="color:red;">\*</mark> | String | contraseña de autenticación   |
| key<mark style="color:red;">\*</mark>  | String | palabra secreta para el token |

{% tabs %}
{% tab title="200 Operación exitosa al crear usuario y token" %}

```json
{
	"status": true,
	"message": "Datos guardados correctamente",
	"data": {
		"usuario": "insomnia",
		"contrasenia": "contrasenia",
		"palabra_secreta": "palabra",
		"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6NywiaXNzIjoiTGVlbmhjcmFmdCIsImF1ZCI6Imluc29tbmlhIiwiZXhwIjoxNjkxMTY5NzM2LCJpYXQiOjE2OTExNjk0MzYsIm5iZiI6MTY5MTE2OTQzNn0.g2LMGuAtIOrkBDkvnUv9Z0fUc-ojxfJTUugqUQSZh-I"
	}
}
```

{% endtab %}

{% tab title="401 Permission denied" %}

{% endtab %}
{% endtabs %}

## Ejemplo de Uso

{% tabs %}
{% tab title="PHP" %}

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://leenhcraft.com/api/auth?user=insomnia&pass=contrasenia&key=palabra",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_SSL_VERIFYPEER => false
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

{% endtab %}
{% endtabs %}