URL-Shortener-API: JSON und Codebeispiele

1. Generieren Sie einen Schlüssel

Verwenden Sie die Homepage, um Ihren API-Schlüssel zu erstellen. Senden Sie es im X-API-KEY-Anfrageheader.

2. Senden Sie Ihre Anfrage

Verwenden Sie POST mit Content-Type: application/json und einem Text, der das URL-Feld enthält.

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

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

3. Lesen Sie die Antwort

Eine erfolgreiche Antwort enthält Status und short_url. Bei einem Fehler lesen Sie das Nachrichtenfeld.

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

4. Integrationsbeispiel

Ersetzen Sie YOUR_API_KEY durch Ihren Schlüssel. Dieses minimale HTML- und JavaScript-Beispiel macht ihn für Besucher sichtbar. Für eine private Integration senden Sie Anfragen vom eigenen Server und halten Zugangsdaten aus dem Browsercode heraus.

<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>

Validierung und Grenzen

Ungültige URLs, private Ziele, blockierte Domänen und übermäßige Anfragen können abgelehnt werden. Wiederholte URLs geben den vorhandenen Kurzlink zurück.

Senden Sie eine URL mit höchstens 2.048 Bytes pro Anfrage. Erlaubt sind bis zu 5 Anfragen je 2 Sekunden pro IP. Beachten Sie bei HTTP 429 Retry-After und vermeiden Sie dauernde Wiederholungen.

Prüfen Sie den HTTP-Status und das JSON-Feld status. Ältere Validierungs- und Schlüsselfehler können HTTP 200 mit status=error liefern. HTTP 405 verlangt POST; HTTP 503 meldet Wartung oder eine ausstehende Prüfung. Wiederholen Sie nur nach Aufforderung und behalten Sie bei Fehlern die ursprüngliche URL.

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

Datenschutzrichtlinie · Kontakt