URL-verkorter-API: JSON en Codevoorbeelden

1. Genereer een sleutel

Gebruik de startpagina om uw API-sleutel aan te maken. Verzend het in de X-API-KEY-verzoekheader.

2. Verstuur uw aanvraag

Gebruik POST met Content-Type: application/json en een body die het URL-veld bevat.

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

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

3. Lees het antwoord

Een succesvol antwoord bevat status en short_url. Als het mislukt, lees dan het berichtveld.

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

4. Integratievoorbeeld

Vervang YOUR_API_KEY door je sleutel. Dit minimale HTML- en JavaScript-voorbeeld maakt de sleutel zichtbaar voor bezoekers. Stuur voor een privé-integratie aanvragen vanaf je eigen server en houd servergegevens buiten de browsercode.

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

Validatie en limieten

Ongeldige URL's, privébestemmingen, geblokkeerde domeinen en buitensporige verzoeken kunnen worden afgewezen. Herhaalde URL's retourneren de bestaande korte link.

Stuur één URL per aanvraag, maximaal 2.048 bytes. Per IP zijn maximaal 5 aanmaakverzoeken per 2 seconden toegestaan. Wacht bij HTTP 429 volgens Retry-After en blijf niet voortdurend opnieuw proberen.

Controleer zowel de HTTP-status als status in de JSON. Oudere validatie- en sleutelfouten kunnen HTTP 200 met status=error teruggeven. HTTP 405 vereist POST; HTTP 503 betekent onderhoud of een lopende controle. Probeer alleen opnieuw wanneer aangegeven en bewaar bij fouten de oorspronkelijke 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"}'

Privacybeleid · Contacteer