Zagl Logo

LLM URL Shortening

Base64 encoding para sa predictable na URL shortening na compatible sa AI system

Pangkalahatang-ideya

Ang ZAGL ay nagbibigay ng LLM-friendly na URL shortening gamit ang Base64 encoding para sa predictable at reproducible na maikling URL. Ito ay ideal para sa mga AI application na nangangailangan ng consistent na URL generation nang hindi nangangailangan ng API key o komplikadong authentication.

LLM Compatible

Idinisenyo para sa AI system

Predictable

Ang parehong URL ay palaging bumubuo ng parehong short code

Walang API Key

Simpleng HTTP request

API Reference

I-encode ang URL

POST /api/llm/encode

Request Body

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

Response

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

I-access ang Maikling URL

GET /e/{base64}

Ang pagbisita sa maikling URL ay awtomatikong magre-redirect sa orihinal na URL. Ang Base64 encoded string ay naglalaman ng orihinal na URL at maaaring predictably ma-decode.

Analytics

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

Kumuha ng analytics data para sa mga URL na ginawa ng LLM. Sumusuporta sa JSON at CSV format.

Mga Query Parameter

  • days: Bilang ng araw (1-365, default: 30)
  • format: Response format (json o csv, default: json)

Mga Limitasyon at Specification

Mga Rate Limit

  • Encoding:: 60 requests/minute
  • Mga Redirect:: 60 requests/minute
  • Analytics:: 120 requests/minute

Mga Constraint

  • Maximum na haba ng URL: 4KB
  • Mga Protocol: HTTP, HTTPS lamang
  • Mga Private IP: Na-block para sa seguridad
  • Nag-e-expire: Hindi kailanman (permanenteng URL)

Mga Halimbawa ng 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

Mga Use Case

Mga LLM Application

  • Mga ChatGPT plugin at integration
  • Claude Code at AI development tool
  • Automated na paggawa ng content
  • AI-powered na link sharing

Automation at Scripting

  • Mga CI/CD pipeline
  • Mga webhook integration
  • Batch URL processing
  • Mga documentation generator

Compatible sa za.gl/llm-docs specification

Huling na-update: 1/13/2026