شعار Zagl

تقصير URL لـ LLM

ترميز Base64 لتقصير URL قابل للتنبؤ ومتوافق مع أنظمة الذكاء الاصطناعي

نظرة عامة

يوفر ZAGL تقصير URL صديق لـ LLM باستخدام ترميز Base64 لعناوين URL قصيرة قابلة للتنبؤ وقابلة للتكرار. هذا مثالي لتطبيقات الذكاء الاصطناعي التي تحتاج إلى توليد URL متسق دون الحاجة إلى مفاتيح API أو مصادقة معقدة.

متوافق مع LLM

مصمم لأنظمة الذكاء الاصطناعي

قابل للتنبؤ

نفس URL ينتج دائمًا نفس الرمز القصير

بدون مفاتيح API

طلبات HTTP بسيطة

مرجع API

ترميز URL

POST /api/llm/encode

نص الطلب

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

الاستجابة

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

الوصول إلى URL القصير

GET /e/{base64}

زيارة URL القصير ستعيد التوجيه تلقائيًا إلى URL الأصلي. تحتوي السلسلة المرمزة بـ Base64 على URL الأصلي ويمكن فك ترميزها بشكل متوقع.

التحليلات

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

احصل على بيانات التحليلات لعناوين URL المولدة بواسطة LLM. يدعم تنسيقات JSON و CSV.

معاملات الاستعلام

  • days: عدد الأيام (1-365، الافتراضي: 30)
  • format: تنسيق الاستجابة (json أو csv، الافتراضي: json)

الحدود والمواصفات

حدود المعدل

  • الترميز:: 60 requests/minute
  • إعادة التوجيه:: 60 requests/minute
  • التحليلات:: 120 requests/minute

القيود

  • الحد الأقصى لطول URL: 4KB
  • البروتوكولات: HTTP، HTTPS فقط
  • عناوين IP الخاصة: محظورة لأسباب أمنية
  • تنتهي: أبدًا (عناوين URL دائمة)

أمثلة على الكود

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

حالات الاستخدام

تطبيقات LLM

  • إضافات وتكاملات ChatGPT
  • Claude Code وأدوات تطوير الذكاء الاصطناعي
  • إنشاء المحتوى التلقائي
  • مشاركة الروابط بالذكاء الاصطناعي

الأتمتة والبرمجة النصية

  • خطوط أنابيب CI/CD
  • تكاملات Webhook
  • معالجة URL دفعية
  • مولدات التوثيق

متوافق مع za.gl/llm-docs المواصفات

آخر تحديث: 12/3/2025

وثائق واجهة برمجة تطبيقات تقصير الروابط LLM | ZAGL