URL शॉर्टनर API: JSON और कोड उदाहरण

1. एक कुंजी उत्पन्न करें

अपनी एपीआई कुंजी बनाने के लिए होमपेज का उपयोग करें। इसे X-API-KEY अनुरोध शीर्षलेख में भेजें।

2. अपना अनुरोध भेजें

सामग्री-प्रकार: एप्लिकेशन/जेसन और यूआरएल फ़ील्ड वाली बॉडी के साथ पोस्ट का उपयोग करें।

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

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

3. प्रतिक्रिया पढ़ें

एक सफल प्रतिक्रिया में स्थिति और शॉर्ट_यूआरएल शामिल होता है। असफल होने पर, संदेश फ़ील्ड पढ़ें.

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

सत्यापन और सीमाएँ

अमान्य यूआरएल, निजी गंतव्य, अवरुद्ध डोमेन और अत्यधिक अनुरोध अस्वीकार किए जा सकते हैं। बार-बार यूआरएल मौजूदा संक्षिप्त लिंक लौटाते हैं।

हर अनुरोध में अधिकतम 2,048 बाइट का एक URL भेजें। प्रति IP हर 2 सेकंड में अधिकतम 5 बनाने के अनुरोध स्वीकार होते हैं। HTTP 429 पर Retry-After के अनुसार रुकें और लगातार दोबारा अनुरोध न भेजें।

HTTP स्थिति और JSON का status दोनों जांचें। पुराने सत्यापन या कुंजी वाले दोष 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"}'

गोपनीयता नीति · संपर्क करें