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/encodeCuerpo 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=jsonObtenga 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
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
// 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
# 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