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://{{instancia}}.arrendasoft.co/service/v2/public/auth/login

{{instancia}}: Hace referencia a la instancia de cada inmobiliaria.

Petición

Método	POST
Content-Type	application/json
Body	`{ "username": "Aquí va el username dado por la inmobiliaria", "password": "Aquí va el password dado por la inmobiliaria" }`

Respuesta

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

message	Mensaje de un posible error por si se presenta.
token	Token bearer para poder realizar la petición de contratos.
expiration	Timestamp de expiración del token, su duración es de 1 hora.

Importante: 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.

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