API ile Otomatik Link Bypass: Geliştiriciler İçin Rehber

Scraper, link toplayıcı, arşivleyici, affiliate denetim aracı ya da güvenlik pipeline'ı kuruyorsan, kısa linkleri elle açmak ölçeklenmez. KısaLinkAtla REST API, kısa link çözmeyi programatik hale getirir: tek bir HTTP isteğiyle asıl adresi ve VirusTotal güvenlik durumunu alırsın.

1. API anahtarı al

Her istek bir API anahtarıyla doğrulanır; anahtarı X-API-Key başlığında gönderirsin. FREE tarife günde 50 istekle başlamak için yeterli. Ölçek büyüdükçe STARTER (500/gün) ve üstü tarifelere geçebilirsin.

2. Tek link çözme

Bir linki çözmek için /bypass uç noktasına POST isteği at. İş kuyruğa alınır ve bir job kimliği döner; sonucu /job/{id} ile sorgularsın.

# Bypass isteği gönder
curl -X POST https://api.kisalinkatla.com/bypass \
  -H "X-API-Key: SENIN_ANAHTARIN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://ouo.io/abc123"}'

# Yanıt: {"job_id": "j_9f2...", "status": "pending"}

# Sonucu sorgula
curl https://api.kisalinkatla.com/job/j_9f2... \
  -H "X-API-Key: SENIN_ANAHTARIN"

# Yanıt (başarılı):
# {
#   "status": "success",
#   "result_url": "https://gercek-hedef.com/dosya",
#   "engine_used": "ouo",
#   "safety_status": "clean"
# }

İpucu: İş kuyruğa alındığı için yanıt anlık olmayabilir. Kısa bir polling aralığı (örn. 1-2 sn) ya da elinde varsa webhook kullan. Aynı link kısa süre içinde tekrar istenirse önbellekten anında döner ve kotadan düşmez.

3. Toplu çözme (batch)

Birden çok linki tek istekte göndermek için /batch/bypass kullan. STARTER ve üstü tarifelerde aktiftir; tarife başına URL limiti değişir (STARTER 10, PRO 50, BUSINESS 100, WEBSITE 500).

curl -X POST https://api.kisalinkatla.com/batch/bypass \
  -H "X-API-Key: SENIN_ANAHTARIN" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://ouo.io/a", "https://tr.link/b", "https://sh.st/c"]}'

# Yanıt: {"batch_id": "b_4d1..."}
# Sonra: GET /batch/b_4d1... ile tüm işlerin durumunu sorgula

import requests, time

API = "https://api.kisalinkatla.com"
HEADERS = {"X-API-Key": "SENIN_ANAHTARIN"}

def bypass(url: str) -> dict:
    r = requests.post(f"{API}/bypass", json={"url": url}, headers=HEADERS)
    job_id = r.json()["job_id"]
    while True:
        s = requests.get(f"{API}/job/{job_id}", headers=HEADERS).json()
        if s["status"] in ("success", "dead"):
            return s
        time.sleep(1.5)

print(bypass("https://ouo.io/abc123"))

4. Limitler ve hata yönetimi

• Günlük kota tarifeye bağlıdır ve her gün sıfırlanır; kota dolunca 429 döner.
• IP başına dakikada 30 istek sınırı vardır (sliding window) — patlamalı trafikte arası ver.
• Başarısız bypass'lar otomatik yeniden denenir; kalıcı başarısızlıklar dead-letter kuyruğuna düşer.
• Her sonuç safety_status alanı taşır (clean / suspicious); güvenlik kritikse bunu kontrol et.

Uyarı: API anahtarını istemci tarafında (tarayıcı, mobil uygulama) gömme. Her zaman kendi sunucundan çağır; anahtar sızarsa kotanı başkaları tüketir.

→ API Tarifelerine Bak