Logo Zagl

Accorciamento URL per LLM

Codifica Base64 per accorciamento URL prevedibile compatibile con sistemi IA

Panoramica

ZAGL fornisce accorciamento URL compatibile con LLM utilizzando la codifica Base64 per URL brevi prevedibili e riproducibili. Questo è ideale per applicazioni IA che necessitano di generazione URL coerente senza richiedere chiavi API o autenticazione complessa.

Compatibile LLM

Progettato per sistemi IA

Prevedibile

Lo stesso URL genera sempre lo stesso codice breve

Senza Chiavi API

Richieste HTTP semplici

Riferimento API

Codifica URL

POST /api/llm/encode

Corpo Richiesta

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

Risposta

{ "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" } }

Accedi all'URL Breve

GET /e/{base64}

Visitando l'URL breve verrai automaticamente reindirizzato all'URL originale. La stringa codificata in Base64 contiene l'URL originale e può essere decodificata in modo prevedibile.

Analisi

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

Ottieni dati analitici per URL generati da LLM. Supporta formati JSON e CSV.

Parametri Query

  • days: Numero di giorni (1-365, predefinito: 30)
  • format: Formato risposta (json o csv, predefinito: json)

Limiti e Specifiche

Limiti di Frequenza

  • Codifica:: 60 requests/minute
  • Reindirizzamenti:: 60 requests/minute
  • Analisi:: 120 requests/minute

Vincoli

  • Lunghezza max URL: 4KB
  • Protocolli: Solo HTTP, HTTPS
  • IP Privati: Bloccati per sicurezza
  • Scade: Mai (URL permanenti)

Esempi di Codice

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

Casi d'Uso

Applicazioni LLM

  • Plugin e integrazioni ChatGPT
  • Claude Code e strumenti di sviluppo IA
  • Generazione automatica di contenuti
  • Condivisione link con IA

Automazione e Scripting

  • Pipeline CI/CD
  • Integrazioni webhook
  • Elaborazione URL in batch
  • Generatori di documentazione

Compatibile con za.gl/llm-docs specifica

Ultimo aggiornamento: 12/3/2025

Documentazione API per Accorciamento URL LLM | ZAGL