Logo de Zagl

Acortamiento de URL para LLM

Codificación Base64 para acortamiento de URL predecible compatible con sistemas de IA

Descripción General

ZAGL proporciona acortamiento de URL amigable para LLM usando codificación Base64 para URLs cortas predecibles y reproducibles. Esto es ideal para aplicaciones de IA que necesitan generación consistente de URL sin requerir claves API o autenticación compleja.

Compatible con LLM

Diseñado para sistemas de IA

Predecible

La misma URL siempre genera el mismo código corto

Sin Claves API

Solicitudes HTTP simples

Referencia de API

Codificar URL

POST /api/llm/encode

Cuerpo de Solicitud

{ "url": "https://example.com/long/url/path" }

Respuesta

{ "success": true, "data": { "shortUrl": "https://za.gl/e/aHR0cHM6Ly9...", "encoded": "aHR0cHM6Ly9leGFtcGxl...", "originalUrl": "https://example.com/...", "method": "base64", "expires": null, "createdAt": "2024-01-01T00:00:00Z" } }

Acceder a URL Corta

GET /e/{base64}

Visitar la URL corta redirigirá automáticamente a la URL original. La cadena codificada en Base64 contiene la URL original y puede decodificarse de manera predecible.

Análisis

GET /api/llm/analytics?days=30&format=json

Obtenga datos analíticos para URLs generadas por LLM. Soporta formatos JSON y CSV.

Parámetros de Consulta

  • days: Número de días (1-365, por defecto: 30)
  • format: Formato de respuesta (json o csv, por defecto: json)

Límites y Especificaciones

Límites de Tasa

  • Codificación:: 60 requests/minute
  • Redirecciones:: 60 requests/minute
  • Análisis:: 120 requests/minute

Restricciones

  • Longitud máxima de URL: 4KB
  • Protocolos: Solo HTTP, HTTPS
  • IPs Privadas: Bloqueadas por seguridad
  • Expira: Nunca (URLs permanentes)

Ejemplos de Código

Python

llm_shortener.py
import base64 import urllib.parse import requests def shorten_url_llm(url): """ Create a predictable shortened URL using Base64 encoding Compatible with ZAGL LLM functionality """ # Validate URL if len(url) > 4096: raise ValueError("URL exceeds 4KB limit") # Encode to Base64 encoded_bytes = base64.b64encode(url.encode('utf-8')) encoded_str = encoded_bytes.decode('utf-8') # Remove padding for cleaner URLs clean_encoded = encoded_str.rstrip('=') # Generate short URL short_url = f"https://yourdomain.com/e/{clean_encoded}" return { "short_url": short_url, "encoded": clean_encoded, "original_url": url } def decode_llm_url(encoded_url): """ Decode a Base64 encoded URL """ # Add padding back if needed padding_needed = 4 - (len(encoded_url) % 4) if padding_needed != 4: encoded_url += '=' * padding_needed # Decode decoded_bytes = base64.b64decode(encoded_url) return decoded_bytes.decode('utf-8') # Example usage original_url = "https://example.com/very/long/url/path" result = shorten_url_llm(original_url) print(f"Short URL: {result['short_url']}") print(f"Encoded: {result['encoded']}")

JavaScript/Node.js

llm_shortener.js
// JavaScript/Node.js implementation function shortenUrlLLM(url) { // Validate URL if (url.length > 4096) { throw new Error("URL exceeds 4KB limit"); } // Validate URL format try { new URL(url); } catch { throw new Error("Invalid URL format"); } // Encode to Base64 const base64 = Buffer.from(url, 'utf-8').toString('base64'); // Remove padding for cleaner URLs const cleanBase64 = base64.replace(/=/g, ''); // Generate short URL const shortUrl = `https://yourdomain.com/e/${cleanBase64}`; return { shortUrl, encoded: cleanBase64, originalUrl: url }; } function decodeLLMUrl(encodedUrl) { // Add padding back if needed let paddedBase64 = encodedUrl; while (paddedBase64.length % 4) { paddedBase64 += '='; } // Decode from Base64 return Buffer.from(paddedBase64, 'base64').toString('utf-8'); } // Example usage const originalUrl = "https://example.com/very/long/url/path"; const result = shortenUrlLLM(originalUrl); console.log(`Short URL: ${result.shortUrl}`); console.log(`Encoded: ${result.encoded}`);

Terminal / cURL

terminal
# Encode a URL curl -X POST https://za.gl/api/llm/encode \ -H "Content-Type: application/json" \ -d '{"url": "https://example.com/very/long/url/path"}' # Get analytics curl "https://za.gl/api/llm/analytics?days=7&format=json" # Get analytics as CSV curl "https://za.gl/api/llm/analytics?days=30&format=csv" \ -o analytics.csv

Casos de Uso

Aplicaciones LLM

  • Plugins e integraciones de ChatGPT
  • Claude Code y herramientas de desarrollo de IA
  • Generación automática de contenido
  • Compartir enlaces con IA

Automatización y Scripting

  • Pipelines CI/CD
  • Integraciones de webhook
  • Procesamiento de URL por lotes
  • Generadores de documentación

Compatible con za.gl/llm-docs especificación

Última actualización: 12/3/2025

Documentación de API de Acortamiento de URL LLM | ZAGL