Logo Zagl

Encurtamento de URL para LLM

Codificação Base64 para encurtamento de URL previsível compatível com sistemas de IA

Visão Geral

ZAGL fornece encurtamento de URL amigável para LLM usando codificação Base64 para URLs curtos previsíveis e reproduzíveis. Isso é ideal para aplicações de IA que precisam de geração de URL consistente sem exigir chaves de API ou autenticação complexa.

Compatível com LLM

Projetado para sistemas de IA

Previsível

O mesmo URL sempre gera o mesmo código curto

Sem Chaves de API

Requisições HTTP simples

Referência da API

Codificar URL

POST /api/llm/encode

Corpo da Requisição

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

Resposta

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

Acessar URL Curto

GET /e/{base64}

Visitar o URL curto redirecionará automaticamente para o URL original. A string codificada em Base64 contém o URL original e pode ser decodificada de forma previsível.

Análises

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

Obtenha dados analíticos para URLs gerados por LLM. Suporta formatos JSON e CSV.

Parâmetros de Consulta

  • days: Número de dias (1-365, padrão: 30)
  • format: Formato de resposta (json ou csv, padrão: json)

Limites e Especificações

Limites de Taxa

  • Codificação:: 60 requests/minute
  • Redirecionamentos:: 60 requests/minute
  • Análises:: 120 requests/minute

Restrições

  • Comprimento máximo do URL: 4KB
  • Protocolos: Apenas HTTP, HTTPS
  • IPs Privados: Bloqueados por segurança
  • Expira: Nunca (URLs permanentes)

Exemplos de Código

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

Casos de Uso

Aplicações LLM

  • Plugins e integrações ChatGPT
  • Claude Code e ferramentas de desenvolvimento IA
  • Geração automática de conteúdo
  • Compartilhamento de links com IA

Automação e Scripting

  • Pipelines CI/CD
  • Integrações webhook
  • Processamento de URL em lote
  • Geradores de documentação

Compatível com za.gl/llm-docs especificação

Última atualização: 12/3/2025

Documentação da API de Encurtamento de URL LLM | ZAGL