API ย่อลิงก์: JSON และตัวอย่างโค้ด

1. สร้างคีย์

ใช้หน้าแรกเพื่อสร้างคีย์ API ของคุณ ส่งในส่วนหัวคำขอ X-API-KEY

2. ส่งคำขอของคุณ

ใช้ POST กับ Content-Type: application/json และเนื้อหาที่มีฟิลด์ url

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

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

3. อ่านคำตอบ

การตอบกลับที่สำเร็จประกอบด้วยสถานะและ short_url เมื่อเกิดความล้มเหลว โปรดอ่านช่องข้อความ

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

4. ตัวอย่างการบูรณาการ

แทน YOUR_API_KEY ด้วยคีย์ของคุณ ตัวอย่าง HTML และ JavaScript แบบย่อนี้ทำให้ผู้เยี่ยมชมเห็นคีย์ได้ หากต้องการเชื่อมต่อแบบส่วนตัว ให้ส่งคำขอจากเซิร์ฟเวอร์ของคุณและไม่ใส่ข้อมูลรับรองในโค้ดเบราว์เซอร์

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

การตรวจสอบความถูกต้องและข้อจำกัด

URL ที่ไม่ถูกต้อง ปลายทางส่วนตัว โดเมนที่ถูกบล็อก และคำขอที่มากเกินไปอาจถูกปฏิเสธ URL ที่ซ้ำกันจะส่งกลับลิงก์แบบสั้นที่มีอยู่

ส่งหนึ่ง URL ต่อคำขอ สูงสุด 2,048 ไบต์ แต่ละ IP สร้างได้สูงสุด 5 คำขอต่อ 2 วินาที เมื่อได้รับ HTTP 429 ให้รอตาม Retry-After และอย่าส่งซ้ำต่อเนื่อง

ตรวจทั้งสถานะ HTTP และค่า status ใน JSON ข้อผิดพลาดการตรวจสอบหรือคีย์แบบเดิมอาจตอบ HTTP 200 พร้อม status=error ส่วน HTTP 405 ต้องใช้ POST และ HTTP 503 หมายถึงปิดปรับปรุงหรือรอการตรวจสอบ ลองใหม่เมื่อมีคำแนะนำและเก็บ 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"}'

นโยบายความเป็นส่วนตัว · ติดต่อ