URL 단축 API: JSON과 코드 예제

1. 키 생성

홈페이지를 사용하여 API 키를 생성하세요. X-API-KEY 요청 헤더로 보내세요.

2. 요청 보내기

Content-Type: application/json 및 url 필드가 포함된 본문과 함께 POST를 사용하세요.

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은 기존의 짧은 링크를 반환합니다.

요청마다 최대 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"}'

개인 정보 보호 정책 · 연락처