Shortmox Tools · entegrasyon rehberi

Short Links — entegrasyon ve güvenlik notları

Kısa bağlantılar panoda oluşturulur; ziyaretçi tarafında herkese açık yönlendirme `/s/[slug]` ile yapılır. Phishing, spam veya dolandırıcılık için kullanılmamalıdır; hedef URL’leri yalnızca güvendiğiniz kaynaklardan yayınlayın.

Bu rehber hukuki veya denetim danışmanlığı değildir. Üretim anahtarlarınızı depolamayın; örneklerde YOUR_* yer tutucuları kullanın. Admin panoları ve çoğu yazma API’si oturum gerektirir — ayrıntılar erişim politikası.

Oluşturma (özet)

POST /api/tools/short-links yalnızca yetkili oturumla (pano) kullanılır; gövde destinationUrl, isteğe bağlı customSlug, title, expiresAt alanlarını kabul eder. Rate limit aşılırsa 429 veya yönlendirme ile hata mesajı dönebilir — gerçek istek gövdesini repoda saklamayın.

Herkese açık yönlendirme

Son kullanıcı /s/YOUR_SLUG yolunu açar; link pasif veya süresi dolmuşsa hata sayfası gösterilir (sayfa noindex olabilir). Yönlendirme hedefi sunucu tarafında doğrulanır; kötü amaçlı hedefleri listelemek sizin süreçlerinize bağlıdır.

QR (SVG)

# QR (SVG) — YOUR_SLUG panoda oluşan kısa kod
curl -sS "https://YOUR_DOMAIN/api/tools/short-links/YOUR_SLUG/qr" -o qr.svg

# Kısa URL (tarayıcı)
open "https://YOUR_DOMAIN/s/YOUR_SLUG"

QR üretimi link kullanılabilir olduğunda SVG döner; kullanılamaz linkte 404 JSON dönebilir.

Abuse ve phishing uyarısı

  • Kısa URL’ler kullanıcıları gizli hedeflere yönlendirebilir — güvenilir markalarda bile dikkatli olun.
  • Tıklama kayıtları teknik amaçlıdır; hukuki delil veya dolandırıcılık tespiti garantisi yoktur.
  • Oran sınırları paylaşılan altyapıyı korumak içindir.

Sık sorulanlar

Kısa linki API ile herkese açık oluşturabilir miyim?

Hayır — oluşturma uç noktası oturum ve telefon doğrulaması gibi kapılar gerektirir; bu rehber yönlendirme ve QR okumasını anlatır.

Herkese açık yönlendirme yolu nedir?

Ziyaretçiler `https://YOUR_DOMAIN/s/SLUG` adresine gider; aktif ve süresi dolmamışsa hedefe yönlendirilir.

QR nasıl alınır?

SVG QR için `GET /api/tools/short-links/SLUG/qr` kullanılır; SLUG yerine gerçek slug koyun — örneklerde yer tutucu kullanın.

Zararlı yazılım taranır mı?

Hedef URL için otomatik güvenlik taraması taahhüdü yoktur; yalnızca bilinen hata durumlarında kullanıcıya kısa mesaj gösterilir.