Proceso de autenticación
Una vez se ha activado la API y se han obtenido las claves proporcionadas por Vivo Recuerdo®, se puede proceder a la autenticación.
Si no has recibido las KEYS, solicítanoslas a través de nuestro chat de soporte en vivorecuerdo.es/clientes
Esta autenticación consiste en una petición HTTP POST contra la URL https://api.vivorecuerdo.es/v1/login con un JSON con el siguiente formato:
{
"client_key": "<clave_cliente>",
"secret_key": "<clave_secreta>"
}
Por ejemplo, con cURL:
curl -X POST https://api.vivorecuerdo.es/v1/login -H "Content-Type: application/json" -d '{"client_key":"cli_220e79d7-ab02-10d63-b30d-953b790098ef", "secret_key":"ke2_528b08a7-258b-1872j-as4d-a36dfdffd8a6"}'
El resultado de esta petición será otro JSON con un token, el cuál permite interaccionar con la API y tiene una caducidad de 1h:
{
"token" : "eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJkZXNhcnJvbGxvIiwiaXNzIjoidml2b3JlY3VlcmRvIiwiaWF0IjoxNTY2NTQxODE3LCJleHAiOjE1NjY1NDU0MTd9.V6wR6DgJMv36-Ktw8YjAu7oT_LlN2Vj4uMeX2ceP0lJjcItzmDKPsEuzkv5kOObN8T6RAQsaGFKQ2ZtcsNMc0Q"
}
Cuando se requiera realizar una transacción con la API y el token haya expirado, habrá que hacer login de nuevo (llamada HTTP POST con las claves en formato JSON contra la URL https://api.vivorecuerdo.es/v1/login, como al principio) para obtener un nuevo token válido.
A partir de aquí, todo sigue esta dinámica: cualquier transacción con la API requerirá un token en el header de la petición. De haber expirado, será necesario solicitar uno válido haciendo login de nuevo.