API Pemendek URL: JSON dan Contoh Kode

1. Hasilkan kunci

Gunakan beranda untuk membuat kunci API Anda. Kirimkan di header permintaan X-API-KEY.

2. Kirim permintaan Anda

Gunakan POST dengan Tipe Konten: application/json dan badan yang berisi bidang url.

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

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

3. Baca jawabannya

Respons yang berhasil berisi status dan short_url. Jika gagal, baca bidang pesan.

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

4. Contoh integrasi

Ganti YOUR_API_KEY dengan kunci Anda. Contoh HTML dan JavaScript minimal ini memperlihatkan kunci kepada pengunjung. Untuk integrasi privat, kirim dari server sendiri dan jangan taruh kredensial server di kode browser.

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

Validasi dan batasan

URL yang tidak valid, tujuan pribadi, domain yang diblokir, dan permintaan berlebihan mungkin ditolak. URL berulang mengembalikan tautan pendek yang ada.

Kirim satu URL per permintaan, maksimal 2.048 byte. Batas pembuatan adalah 5 permintaan per 2 detik per IP. Jika mendapat HTTP 429, tunggu sesuai Retry-After dan hindari pengulangan terus-menerus.

Periksa status HTTP dan kolom status JSON. Galat validasi atau kunci versi lama dapat mengembalikan HTTP 200 dengan status=error. HTTP 405 memerlukan POST; HTTP 503 berarti pemeliharaan atau pemeriksaan tertunda. Coba lagi hanya saat disarankan dan simpan URL asli jika gagal.

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

Kebijakan privasi · Kontak