Logo Zagl

Scurtare URL pentru LLM

Codificare Base64 pentru scurtarea URL predictibilă compatibilă cu sistemele AI

Prezentare Generală

ZAGL oferă scurtarea URL prietenoasă pentru LLM folosind codificarea Base64 pentru URL-uri scurte predictibile și reproductibile. Acest lucru este ideal pentru aplicațiile AI care necesită generare consistentă de URL-uri fără a necesita chei API sau autentificare complexă.

Compatibil LLM

Proiectat pentru sisteme AI

Predictibil

Același URL generează întotdeauna același cod scurt

Fără Chei API

Cereri HTTP simple

Referință API

Codificare URL

POST /api/llm/encode

Corp Cerere

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

Răspuns

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

Accesare URL Scurt

GET /e/{base64}

Vizitarea URL-ului scurt va redirecționa automat către URL-ul original. Șirul codificat Base64 conține URL-ul original și poate fi decodificat predictibil.

Analize

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

Obțineți date analitice pentru URL-uri generate de LLM. Suportă formatele JSON și CSV.

Parametri Interogare

  • days: Număr de zile (1-365, implicit: 30)
  • format: Format răspuns (json sau csv, implicit: json)

Limite și Specificații

Limite de Rată

  • Codificare:: 60 requests/minute
  • Redirecționări:: 60 requests/minute
  • Analize:: 120 requests/minute

Constrângeri

  • Lungime maximă URL: 4KB
  • Protocoale: Doar HTTP, HTTPS
  • IP-uri Private: Blocate pentru securitate
  • Expiră: Niciodată (URL-uri permanente)

Exemple de Cod

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

Cazuri de Utilizare

Aplicații LLM

  • Plugin-uri și integrări ChatGPT
  • Claude Code și instrumente de dezvoltare AI
  • Generare automată de conținut
  • Partajare link-uri cu AI

Automatizare și Scripting

  • Pipeline-uri CI/CD
  • Integrări webhook
  • Procesare URL în lot
  • Generatoare de documentație

Compatibil cu za.gl/llm-docs specificație

Ultima actualizare: 12/3/2025

Documentație API pentru Scurtare URL LLM | ZAGL