Logo Zagl

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/encode

Corps 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=json

Obtenez 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

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

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

Documentation API de Raccourcissement d'URL LLM | ZAGL