API Rút Gọn URL: JSON và Ví Dụ Mã

1. Tạo khóa

Sử dụng trang chủ để tạo khóa API của bạn. Gửi nó trong tiêu đề yêu cầu X-API-KEY.

2. Gửi yêu cầu của bạn

Sử dụng POST với Content-Type: application/json và phần nội dung chứa trường url.

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

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

3. Đọc phản hồi

Phản hồi thành công chứa trạng thái và short_url. Khi thất bại, hãy đọc trường thông báo.

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

4. Ví dụ tích hợp

Thay YOUR_API_KEY bằng khóa của bạn. Ví dụ HTML và JavaScript tối giản này để khách truy cập nhìn thấy khóa. Muốn tích hợp riêng tư, hãy gửi yêu cầu từ máy chủ của bạn và giữ thông tin xác thực ngoài mã trình duyệt.

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

Xác nhận và giới hạn

URL không hợp lệ, đích đến riêng tư, tên miền bị chặn và yêu cầu quá mức có thể bị từ chối. URL lặp lại trả về liên kết ngắn hiện có.

Gửi một URL mỗi yêu cầu, tối đa 2.048 byte. Mỗi IP được gửi tối đa 5 yêu cầu tạo link trong 2 giây. Khi gặp HTTP 429, chờ theo Retry-After, không gửi lại liên tục.

Kiểm tra cả trạng thái HTTP và trường status trong JSON. Lỗi URL hoặc khóa theo cơ chế cũ có thể trả HTTP 200 với status=error. HTTP 405 yêu cầu POST; HTTP 503 là bảo trì hoặc kiểm tra đang chờ. Chỉ thử lại khi được chỉ dẫn và giữ URL gốc nếu thất bại.

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

Chính sách bảo mật · Liên hệ