QRT

Introducción

Esta API permite acortar URLs y textos, y recuperar el contenido original a partir de un código corto.

La API tiene tres funcionalidades principales:

1. Crear un enlace corto: Genera un enlace corto a partir de una URL o un texto.
2. Obtener el contenido original: A partir de un enlace corto, se obtiene la URL o texto original.
3. Obtener el contenido en texto plano: Obtiene la URL o texto original en formato de texto plano para uso en terminales u otros entornos.

Estructura Básica

La API se compone de tres endpoints:

• POST /api/shorten - Para crear un enlace corto.
• GET /api/<short_code> - Para obtener la URL o texto largo usando el código corto en formato JSON.
• GET /raw/<short_code> - Para obtener la URL o texto largo en formato de texto plano.

Autenticación

Actualmente, esta API no requiere autenticación para el acceso.

Endpoints

1. Crear un enlace corto

URL: /api/shorten

Método: POST

Descripción: Genera un enlace corto a partir de una URL o texto largo.

Body (JSON):

{
  "long_url": "https://www.ejemplodeurlmuylargaderecordar.com/a/b/c/123"
}

Ejemplo de solicitud:

{
  "long_url": "https://www.ejemplodeurlmuylargaderecordar.com/a/b/c/123"
}

Ejemplo de respuesta:

{
  "short_code": "abc123",
  "short_url": "qrt.cl/abc123"
}

2. Obtener la URL o texto original desde el código corto (formato JSON)

URL: /api/<short_code>

Método: GET

Descripción: Devuelve la URL o texto original a partir de un código corto en formato JSON.

Parámetros en la URL:

• short_code: Código único del contenido corto (obligatorio).

Ejemplo de solicitud:

GET /api/abc123

Ejemplo de respuesta (éxito):

{
  "long_url": "https://www.ejemplodeurlmuylargaderecordar.com/a/b/c/123"
}

Respuesta de error:

{
  "error": "Contenido no encontrado"
}

3. Obtener el contenido en texto plano

URL: /raw/<short_code>

Método: GET

Descripción: Devuelve el contenido original (URL o texto) en formato de texto plano, ideal para uso en terminales.

Parámetros en la URL:

• short_code: Código único del contenido corto (obligatorio).

Ejemplo de solicitud:

GET /raw/abc123

Ejemplo de respuesta (éxito):

https://www.ejemplodeurlmuylargaderecordar.com/a/b/c/123

Respuesta de error:

Contenido no encontrado

Códigos de Estado HTTP

• 201: Creación exitosa (cuando se genera un nuevo enlace corto).
• 200: Solicitud exitosa (cuando se encuentra el contenido original).
• 400: Solicitud incorrecta (cuando falta long_url en la creación).
• 404: No encontrado (cuando el código corto no existe).

Ejemplo Práctico

Para acortar "https://www.ejemplodeurlmuylargaderecordar.com/a/b/c/123", envía:

{
  "long_url": "https://www.ejemplodeurlmuylargaderecordar.com/a/b/c/123"
}

Recibirás un enlace corto como: qrt.cl/abc123.

Para obtener la URL original en formato JSON, realiza:

GET /api/abc123

Para obtener el contenido en texto plano, realiza:

GET /raw/abc123

Si el código existe, recibirás el contenido en el formato adecuado.

Contáctanos

Tienes alguna duda o sugerencia? Contáctanos en: contacto@qrt.cl