2. Autenticación

Para acceder a las URL de nuestra API, es necesario generar un token de acceso. Antes de obtener un token, el usuario debe contar con un nombre de usuario y contraseña válidos para acceder a Efranco v4.0.

Es importante mencionar que la contraseña está encriptada mediante el método AES-128-CBC en el documento de la API. Esto puede ser agregado en la sección que habla sobre el parámetro "clave" de la siguiente manera:

Obtener un token de acceso

URL: https://gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com/api/auth/login
Método HTTP: POST
Nombre del servicio: login

Entradas

Parámetro	Tipo de dato	Descripción

Parámetro	Tipo de dato	Descripción
nickname	string	Nombre de usuario otorgado por Zona Franca
password	string	Contraseña del usuario, encriptada mediante el método AES-128-CBC.
flag	integer	Se debe enviar un campo tipo bandera que indique si el usuario está conectado mediante webservices(1).

Salidas

Atributo	Tipo de dato	Descripción

Atributo	Tipo de dato	Descripción
token	string	Token de acceso requerido para consumir los servicios de la API
token_type	string	Tipo de token generado, que en este caso es "bearer"

Petición:

bashCopy codePOST /api/auth/login HTTP/1.1
Host: gorgeous-dust-0seusmuxapkp.vapor-farm-b1.com
Content-Type: application/json

{
  "nickname":"technisupport",
  "password":"ciphertext."
}

Respuesta

{
"status": {
"code": 200,
"message": "Procesado con éxito",
"last_access": "2023-04-25 09:29:03",
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL2dvcmdlb3VzLWR1c3QtMHNldXNtdXhhcGtwLnZhcG9yLWZhcm0tYjEuY29tL2FwaS9hdXRoL2xvZ2luIiwiaWF0IjoxNjgyNDMzMDA5LCJleHAiOjE2ODI0NDAyMDksIm5iZiI6MTY4MjQzMzAwOSwianRpIjoiWlZJYnQxazFNUHBNMHFENSIsInN1YiI6IjM0IiwicHJ2IjoiMjNiZDVjODk0OWY2MDBhZGIzOWU3MDFjNDAwODcyZGI3YTU5NzZmNyJ9.6MfPZlxdlY7ShhSsRzAzVAAWYVS7N19R6pQu0CAMN4A",
"expires_at": "en 1 hora",
"date_expires": "2023-04-25 11:30:09",
"token_type": "bearer",
"user": {
"id": 34,
"email": "technisupport@technisupport",
"nickname": "technisupport",
"nickname_nit": "technisupport@9010024370",
"token": null,
"token_login": null,
"token_email": null,
"token_time": null,
"session_id": "8d14b623bf291312846072ea75c30d97",
"confirmation_code": "bjHYT61jnmOEHHGBfzq2x7ibNjGPlDFz0etmwEZ8ugWTmcwUOThGOqoqi6UFnM1tmY7xFGg1YEoz2Ce7ps9B2Ytxle4j2IAB4JS8Hcbk0YPC6PWtMmRctnI2SonBWeae7hoeHm8whGyeqJ2nuLmEnCu9OOMlad8NeWPOhyVjA8WcSfuAiaXWPR8PfvhvLBk674D8UPBNLBxfRr4opNbj5zbTU5nFyKqW0VvU20s0z18RSakRt43S3ADlev",

}