API de Liens Courts : JSON et Exemples

1. Générez une clé

Utilisez la page d'accueil pour créer votre clé API. Envoyez-le dans l'en-tête de requête X-API-KEY.

2. Envoyez votre demande

Utilisez POST avec Content-Type : application/json et un corps contenant le champ URL.

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

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

3. Lisez la réponse

Une réponse réussie contient status et short_url. En cas d'échec, lisez le champ de message.

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

4. Exemple d'intégration

Remplacez YOUR_API_KEY par votre clé. Cet exemple minimal HTML et JavaScript expose la clé aux visiteurs. Pour une intégration privée, envoyez les requêtes depuis votre serveur et gardez ses identifiants hors du navigateur.

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

Validation et limites

Les URL invalides, les destinations privées, les domaines bloqués et les demandes excessives peuvent être rejetées. Les URL répétées renvoient le lien court existant.

Envoyez une URL par requête, jusqu’à 2 048 octets. La limite est de 5 requêtes par période de 2 secondes et par IP. Après HTTP 429, respectez Retry-After et évitez les tentatives en boucle.

Vérifiez le statut HTTP et le champ status du JSON. Certaines erreurs historiques de validation ou de clé renvoient HTTP 200 avec status=error. HTTP 405 exige POST ; HTTP 503 indique une maintenance ou une vérification en attente. Réessayez seulement lorsque c’est indiqué et conservez l’URL d’origine en cas d’échec.

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

Politique de confidentialité · Contacter