URL Kısaltma API: JSON ve Kod Örnekleri

1. Bir anahtar oluşturun

API anahtarınızı oluşturmak için ana sayfayı kullanın. X-API-KEY istek başlığında gönderin.

2. İsteğinizi gönderin

POST'u Content-Type: application/json ve url alanını içeren bir gövde ile kullanın.

POST https://freetoolsweb.com/short-url/?api=create
Content-Type: application/json
X-API-KEY: YOUR_API_KEY

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

3. Yanıtı okuyun

Başarılı bir yanıt, durumu ve short_url'yi içerir. Arıza durumunda mesaj alanını okuyun.

{"status": "success", "short_url": "https://gothis.link/Ab12"}

4. Entegrasyon örneği

YOUR_API_KEY yerine anahtarınızı yazın. Bu küçük HTML ve JavaScript örneği anahtarı ziyaretçilere gösterir. Özel entegrasyon için istekleri kendi sunucunuzdan gönderin ve sunucu kimlik bilgilerini tarayıcı koduna koymayın.

<form id="short-url-form">
  <label for="long-url">Website URL</label>
  <input id="long-url" name="url" type="url" placeholder="https://example.com" required>
  <button type="submit">Shorten</button>
</form>
<div id="result" role="status"></div>

<script>
document.getElementById("short-url-form").addEventListener("submit", async function(event) {
  event.preventDefault();
  const button = this.querySelector("button");
  const result = document.getElementById("result");
  button.disabled = true; result.textContent = "Processing...";
  try {
    const response = await fetch("https://freetoolsweb.com/short-url/?api=create", {
      method: "POST",
      headers: {"Content-Type": "application/json", "X-API-KEY": "YOUR_API_KEY"},
      body: JSON.stringify({url: document.getElementById("long-url").value.trim()})
    });
    const data = await response.json();
    if (!response.ok || data.status !== "success") throw new Error(data.message || "Request failed.");
    const url = new URL(data.short_url);
    if (!["http:", "https:"].includes(url.protocol)) throw new Error("Invalid response.");
    const link = document.createElement("a");
    link.href = url.href; link.textContent = url.href;
    link.target = "_blank"; link.rel = "noopener noreferrer";
    result.replaceChildren(link);
  } catch (error) { result.textContent = error.message || "Connection failed."; }
  finally { button.disabled = false; }
});
</script>

Doğrulama ve sınırlar

Geçersiz URL'ler, özel hedefler, engellenen alanlar ve aşırı istekler reddedilebilir. Tekrarlanan URL'ler mevcut kısa bağlantıyı döndürür.

Her istekte en fazla 2.048 baytlık bir URL gönderin. Her IP için 2 saniyede en fazla 5 oluşturma isteği kabul edilir. HTTP 429 durumunda Retry-After süresini bekleyin; sürekli yeniden denemeyin.

HTTP durumunu ve JSON status alanını birlikte kontrol edin. Eski doğrulama veya anahtar hataları HTTP 200 ile status=error döndürebilir. HTTP 405 POST gerektirir; HTTP 503 bakım veya bekleyen kontrol demektir. Yalnızca belirtildiğinde yeniden deneyin ve hata halinde asıl URL’yi saklayın.

{"status": "error", "message": "Invalid URL"}
{"status": "error", "code": "rate_limited", "message": "Too many requests, please try again."}

cURL

curl -X POST 'https://freetoolsweb.com/short-url/?api=create' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  --data '{"url":"https://example.com"}'

Gizlilik politikası · İletişim