# Autenticación

En esta sección, explicaremos los servicios que se ofrecen para la gestión de autenticación en la API REST de Arrendasoft®.

# Login

Permite realizar el login en la API, para obtener el token necesario a usar en los demás servicios.

**Endpoint:** https://<span style="color: rgb(241, 196, 15);">**{{instancia}}**</span>.arrendasoft.co/service/v2/public/auth/login

**<span style="color: rgb(241, 196, 15);">{{instancia}}</span>:** Hace referencia a la instancia de cada inmobiliaria.

#### **Petición**

<table border="1" id="bkmrk-m%C3%A9todo-post-content-" style="border-collapse: collapse; width: 100%; height: 172.141px;"><colgroup><col style="width: 18.3929%;"></col><col style="width: 81.7263%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Método**</td><td style="height: 29.7969px;">POST</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Content-Type**</td><td style="height: 29.7969px;">application/json</td></tr><tr style="height: 112.547px;"><td style="height: 112.547px;">**Body**</td><td style="height: 112.547px;">```json
{
    "username": "Aquí va el username dado por la inmobiliaria",
    "password": "Aquí va el password dado por la inmobiliaria"
}
```

  
</td></tr></tbody></table>

#### **Respuesta**

```json
{
  "message": null,
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpYXQiOjE2OTA0OTc1OTAsImV4cCI6MTY5MDU0MDc5MCwiZGF0YSI6eyJ0ZXJjZXJvX2lkIjoiNjQ4MiIsImRvY3VtZW50byI6InVzZXJfYXZhbnRvIn19.5OlAA_hg1NZ3xfjVqaDaf-j46JqiBcOUdHC1dwwUK38",
  "expiration": 1690540790
}
```

<table border="1" id="bkmrk-message-mensaje-de-u" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 14.5834%;"></col><col style="width: 85.5358%;"></col></colgroup><tbody><tr><td>**message**</td><td>Mensaje de un posible error por si se presenta.</td></tr><tr><td>**token**</td><td>Token bearer para poder realizar la petición de contratos.</td></tr><tr><td>**expiration**</td><td>Timestamp de expiración del token, su duración es de 1 hora.</td></tr></tbody></table>

<span style="color: rgb(224, 62, 45);">**Importante:**</span> Es importante tener en cuenta que al realizar solicitudes a otros servicios, es posible que el token expire. En tales casos, será necesario volver a autenticarse utilizando el servicio de login.

```json
{
    "statusCode": 401,
    "error": {
        "type": "SERVER_ERROR",
        "description": "JWT Token expired."
    }
}
```