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 در هر 2 ثانیه حداکثر 5 درخواست ساخت دارد. در 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"}'

سیاست حفظ حریم خصوصی · تماس بگیرید