URL শর্টনার API: JSON ও কোডের উদাহরণ

1. একটি কী তৈরি করুন

আপনার API কী তৈরি করতে হোমপেজটি ব্যবহার করুন। এটিকে X-API-KEY অনুরোধ শিরোনামে পাঠান।

2. আপনার অনুরোধ পাঠান

বিষয়বস্তু-প্রকারের সাথে POST ব্যবহার করুন: অ্যাপ্লিকেশন/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, ব্যক্তিগত গন্তব্য, অবরুদ্ধ ডোমেন এবং অত্যধিক অনুরোধ প্রত্যাখ্যান করা হতে পারে। বারবার ইউআরএল বিদ্যমান ছোট লিঙ্ক ফিরিয়ে দেয়।

প্রতি অনুরোধে সর্বোচ্চ 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"}'

গোপনীয়তা নীতি · যোগাযোগ