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 |
|
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."
}
}Ejemplos
Curl
curl -X POST "https://{{instancia}}.arrendasoft.co/service/v2/public/auth/login" -H "Content-Type: application/json" -d "{\"username\": \"YOUR_USERNAME\", \"password\": \"YOUR_PASSWORD\"}"PHP Curl
<?php
$instance = 'tu_instancia'; // Reemplaza con tu instancia real
$username = 'TU_NOMBRE_DE_USUARIO'; // Reemplaza con el nombre de usuario proporcionado por la inmobiliaria
$password = 'TU_CONTRASEÑA'; // Reemplaza con la contraseña proporcionada por la inmobiliaria
$url = "https://{$instance}.arrendasoft.co/service/v2/public/auth/login";
$data = json_encode([
'username' => $username,
'password' => $password
]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Content-Length: ' . strlen($data)
]);
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (curl_errno($ch)) {
echo 'Error:' . curl_error($ch);
} else {
echo "Código de estado HTTP: " . $http_code . "\n";
echo "Respuesta: " . $response . "\n";
$responseData = json_decode($response, true);
if (isset($responseData['token'])) {
$token = $responseData['token'];
echo "Token de Autenticación: " . $token . "\n";
} else {
echo "Autenticación fallida. No se recibió ningún token.\n";
}
}
curl_close($ch);
?>