Raccourcissement d'URL pour LLM
Encodage Base64 pour un raccourcissement d'URL prévisible compatible avec les systèmes IA
Aperçu
ZAGL fournit un raccourcissement d'URL convivial pour les LLM utilisant l'encodage Base64 pour des URLs courtes prévisibles et reproductibles. C'est idéal pour les applications IA qui nécessitent une génération d'URL cohérente sans nécessiter de clés API ou d'authentification complexe.
Compatible LLM
Conçu pour les systèmes IA
Prévisible
La même URL génère toujours le même code court
Sans Clés API
Requêtes HTTP simples
Référence API
Encoder l'URL
POST /api/llm/encodeCorps de Requête
{ "url": "https://example.com/long/url/path" }
Réponse
{ "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" } }
Accéder à l'URL Courte
GET /e/{base64}Visiter l'URL courte redirigera automatiquement vers l'URL d'origine. La chaîne encodée en Base64 contient l'URL d'origine et peut être décodée de manière prévisible.
Analyses
GET /api/llm/analytics?days=30&format=jsonObtenez des données analytiques pour les URLs générées par LLM. Prend en charge les formats JSON et CSV.
Paramètres de Requête
days: Nombre de jours (1-365, par défaut : 30)format: Format de réponse (json ou csv, par défaut : json)
Limites et Spécifications
Limites de Taux
- • Encodage :: 60 requests/minute
- • Redirections :: 60 requests/minute
- • Analyses :: 120 requests/minute
Contraintes
- • Longueur max URL : 4KB
- • Protocoles : HTTP, HTTPS uniquement
- • IPs Privées : Bloquées pour la sécurité
- • Expire : Jamais (URLs permanentes)
Exemples de Code
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
Cas d'Utilisation
Applications LLM
- • Plugins et intégrations ChatGPT
- • Claude Code et outils de développement IA
- • Génération automatique de contenu
- • Partage de liens avec IA
Automatisation et Scripting
- • Pipelines CI/CD
- • Intégrations webhook
- • Traitement d'URL par lots
- • Générateurs de documentation
Compatible avec za.gl/llm-docs spécification
Dernière mise à jour : 12/3/2025