Zagl Logo

LLM zkracování URL

Base64 kódování pro předvídatelné zkracování URL kompatibilní s AI systémy

Přehled

ZAGL poskytuje LLM-přátelské zkracování URL pomocí Base64 kódování pro předvídatelné, reprodukovatelné krátké URL. To je ideální pro AI aplikace, které potřebují konzistentní generování URL bez nutnosti API klíčů nebo složité autentizace.

LLM kompatibilní

Navrženo pro AI systémy

Předvídatelné

Stejná URL vždy generuje stejný krátký kód

Bez API klíčů

Jednoduché HTTP požadavky

API Reference

Zakódovat URL

POST /api/llm/encode

Tělo požadavku

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

Odpověď

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

Přístup ke krátké URL

GET /e/{base64}

Návštěva krátké URL automaticky přesměruje na původní URL. Base64 zakódovaný řetězec obsahuje původní URL a lze ho předvídatelně dekódovat.

Analytika

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

Získejte analytická data pro LLM-generované URL. Podporuje formáty JSON a CSV.

Parametry dotazu

  • days: Počet dní (1-365, výchozí: 30)
  • format: Formát odpovědi (json nebo csv, výchozí: json)

Limity a specifikace

Limity požadavků

  • Kódování:: 60 requests/minute
  • Přesměrování:: 60 requests/minute
  • Analytika:: 120 requests/minute

Omezení

  • Max délka URL: 4KB
  • Protokoly: Pouze HTTP, HTTPS
  • Privátní IP: Blokováno z bezpečnostních důvodů
  • Vyprší: Nikdy (trvalé URL)

Příklady kódu

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}`);

Terminál / 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

Případy použití

LLM aplikace

  • ChatGPT pluginy a integrace
  • Claude Code a AI vývojové nástroje
  • Automatizovaná tvorba obsahu
  • AI-poháněné sdílení odkazů

Automatizace a skriptování

  • CI/CD pipelines
  • Integrace webhooků
  • Dávkové zpracování URL
  • Generátory dokumentace

Kompatibilní s za.gl/llm-docs specifikací

Naposledy aktualizováno: 1/13/2026