Version 1.0.0

Last Updated: April 8, 2025

Responsible: Luis Amaya

Generación

Introducción:

Generador es el componente de Links encargado del acortamiento de Urls, y creación de códigos QR

Métodos de autenticación

Este servicio se autentica por medio del servicio de autenticación que provee plataforma Masiv, se puede autenticar por medio del header de Authorization con un Bearer o Basic Token.

Headers:
Authorization: Bearer/Basic <Authentication Token>

Formatos

Endpoints

Los siguientes endpoints realizan la función de acortar URLs.

Shorter tiene como función acortar 1 o más URLs y devolver el Link o los múltiples Links cortos. QR tiene como función acortar 1 URL y devolver en Base 64 un Código QR que representa la URL acortada.

Ambos endpoints son métodos tipo POST cuyo cuerpo y respuesta son de formato JSON.

POST Shorter

POST QR

Códigos de respuesta

Código Nombre Descripción
🟢200 Success Petición exitosa
🟠400 Bad Request Petición errónea por error en alguno de los párametros de la petición
🟠401 Unauthorized Cliente no autorizado / Credenciales inválidas
🟠403 Forbidden Token incorrecto / Usuario no tiene permiso para acceder a los recursos
🟠404 Not Found Recurso o ruta no existente
🔴500 Internal Server Error Error interno del recurso
🔴503 Service Unavailable Recurso / Servicio no disponible

Redirección

Introducción