Integrando Broslunas Links en Pau Calculator: Enlaces cortos y elegantes

¡Hola de nuevo! 👋

Hoy quiero compartir con vosotros una mejora que he implementado en Pau Calculator y que me tiene especialmente contento: la integración con Broslunas Links, mi propio servicio de acortamiento de URLs.

El problema: URLs demasiado largas

Si habéis usado Pau Calculator, sabréis que permite compartir vuestros cálculos mediante un enlace. El problema es que estos enlaces eran… digamos que poco elegantes:

https://pau.broslunas.com/#/s/eNqNk92OgjAQhd9lrolZm1XXvsrGNKUUGIOtS8Esa3z3ndqysSBxb_g5U86c-VqucAHOMuiBA5pKG9QtSoGmtO1JdqgkZJAjVfNBuD4_atV5pQS-W23ZOz064J-Qi0abqpdCSdfpppFGirVfOOr6u2ulOep21EtsrLMl3hsIXfRKKrSGdBe7PrFkC5ZBr9F11sfX7kyrUy3tR7PpMJ_7y-P7iq8eT_4exE4rYxtb4Sg8gBEFVtjJBn9C8DUFNTNz9mjOpqbslSm7mx5oVQX8uoCZb5dA812KOrzPYPP12xLv8MUz4qEyZT5Rp61T7mO8CfkgJ-xjwpf4-X6-AUkXFmklm0Bneb__105QjlsGlfObMcNF1qtNBjNYUR-hxNeTLci9kIVQttU-w4asL_53ugJdgXLUQjk6IlWsBv1cDzRK1LejSgPV94mGUPi4HW6_M_NXBA

Sí, ese monstruo de 600+ caracteres era lo que se generaba al compartir un cálculo. Nada práctico para compartir en redes sociales, mensajes o simplemente recordar.

La solución: Broslunas Links

La solución era obvia: necesitaba un acortador de enlaces. Pero en lugar de usar servicios de terceros como bit.ly o tinyurl, decidí usar el mío propio: Broslunas Links.

Ahora, cuando compartes un cálculo en Pau Calculator, obtienes un enlace limpio y profesional:

https://broslunas.link/pau-xxxxxx

Mucho mejor, ¿verdad? 🎉

¿Cómo funciona la integración?

La integración es sorprendentemente sencilla gracias a la API pública de Broslunas Links. Aquí os explico el proceso:

1. Llamada a la API

Cuando un usuario hace clic en “Compartir” en Pau Calculator, la aplicación realiza una petición POST a:

POST https://broslunas.link/api/v1/links

2. Estructura de la petición

El cuerpo de la petición incluye:

{
  "url": "https://pau.broslunas.com/#/s/eNqNk92Og...",
  "slug": "pau-a3f9b2",
  "title": "Cálculo de PAU - 23/11/2025",
  "description": "Cálculo compartido desde Pau Calculator",
}

Detalles importantes:

• url: La URL original (larga) que queremos acortar
• slug: Un identificador único con el formato pau-XXXXXX (generado aleatoriamente)
• title y description: Metadatos para mejorar el SEO y la previsualización en redes sociales
• isPublicStats: Configurado como false para mantener las estadísticas privadas

3. Autenticación

La API requiere autenticación mediante Bearer Token:

headers: {
  'Authorization': 'Bearer YOUR_TOKEN_HERE',
  'Content-Type': 'application/json'
}

4. Respuesta de la API

Si todo va bien, la API responde con:

{
  "success": true,
  "data": {
    "id": "clx123abc...",
    "shortUrl": "https://broslunas.link/pau-a3f9b2",
    "originalUrl": "https://pau.broslunas.com/#/s/eNqNk92Og...",
    "slug": "pau-a3f9b2",
    "clicks": 0,
    "createdAt": "2025-11-23T15:30:00Z"
  }
}

¡Y listo! Ya tenemos nuestro enlace corto listo para compartir.

Implementación en código

Aquí os dejo un ejemplo simplificado de cómo implementar esto en vuestros proyectos:

async function createShortLink(originalUrl) {
  try {
    const response = await fetch('https://broslunas.link/api/v1/links', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${YOUR_API_TOKEN}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        url: originalUrl,
        slug: `pau-${generateRandomId()}`, // Genera un ID único
        title: 'Mi título personalizado',
        description: 'Mi descripción',
        isPublicStats: false
      })
    });

    const data = await response.json();
    
    if (data.success) {
      return data.data.shortUrl;
    } else {
      throw new Error('Error al crear el enlace corto');
    }
  } catch (error) {
    console.error('Error:', error);
    return originalUrl; // Fallback a la URL original
  }
}

function generateRandomId() {
  return Math.random().toString(36).substring(2, 8);
}

Ventajas de usar Broslunas Links

✅ URLs limpias y profesionales: Mucho más fáciles de compartir y recordar
✅ Control total: Al ser mi propio servicio, tengo control completo sobre los datos
✅ Estadísticas: Puedo ver cuántas veces se ha compartido cada cálculo
✅ Personalización: Puedo usar mi propio dominio y formato de slug
✅ Sin límites: No dependo de cuotas de servicios de terceros

¿Quieres usar la API en tus proyectos?

¡La API de Broslunas Links es pública y gratuita! Si queréis integrar un acortador de enlaces en vuestros proyectos, podéis usar la misma API.

📚 Documentación completa: https://broslunas.link/api

En la documentación encontraréis:

• Endpoints disponibles
• Ejemplos de uso
• Límites de uso
• Cómo obtener vuestro token de API
• Casos de uso y mejores prácticas

Conclusión

Esta integración es un ejemplo perfecto de cómo construir ecosistemas de aplicaciones que se complementan entre sí. Pau Calculator ahora genera enlaces más limpios gracias a Broslunas Links, y ambos proyectos se benefician mutuamente.

Si tenéis alguna pregunta sobre la integración o queréis usar la API en vuestros proyectos, no dudéis en contactarme. ¡Estaré encantado de ayudaros!

---

🚀 Happy coding!