API

API Raccourcisseur gratuite

Tester l'API — Entrez une URL
Autres outils Raccourcisseur d'URL Générateur de QR Code

Lejumo propose une API de raccourcissement d'URL gratuite et sans clé d'authentification. Elle expose deux endpoints : POST /api/shorten pour créer un lien valable 90 jours, GET /api/stats/{code} pour consulter le nombre de clics. Les liens créés via l'API sont renouvelables pour 90 jours supplémentaires en rappelant le même endpoint entre le jour 60 et le jour 90.

Deux endpoints, zéro inscription

L'API Lejumo ne nécessite aucun compte, aucune clé API et aucun en-tête d'autorisation. Il suffit d'envoyer une requête HTTP standard pour obtenir un lien court en moins d'une seconde. Les deux endpoints disponibles couvrent l'essentiel des besoins : création d'un lien court et consultation de ses statistiques de clics. L'API accepte les requêtes depuis n'importe quelle origine (CORS *), ce qui permet de l'appeler directement depuis un navigateur en JavaScript côté client.

Créer un lien court — POST /api/shorten

Envoyez une requête POST avec un corps JSON contenant le champ url. Le lien créé est valable 90 jours. Si vous appelez le même endpoint avec la même URL entre le jour 60 et le jour 90, la validité est prolongée de 90 jours supplémentaires (renouvellement automatique).

curl -X POST https://www.lejumo.com/api/shorten \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.exemple.fr"}'

# Réponse 200
{
  "short":      "https://lejumo.com/abc123",
  "code":       "abc123",
  "expires_at": 1796000000,
  "renewed":    false
}

Le champ expires_at est un timestamp Unix (secondes). Le champ renewed vaut true si la requête a déclenché un renouvellement de la durée de validité.

Consulter les statistiques — GET /api/stats/{code}

Récupérez le nombre de clics enregistrés pour un lien court en passant son code dans le chemin de l'URL. Les statistiques sont anonymes : aucune donnée personnelle du visiteur n'est collectée.

curl https://www.lejumo.com/api/stats/abc123

# Réponse 200
{
  "code":   "abc123",
  "clicks": 42,
  "short":  "https://lejumo.com/abc123"
}

# Réponse 404 (code inexistant ou expiré)
{
  "error": "not_found"
}

Renouvellement automatique : comment prolonger vos liens

Les liens créés via l'API ont une durée de validité fixe de 90 jours. Pour éviter l'expiration, l'API intègre un mécanisme de renouvellement : si vous rappelez POST /api/shorten avec la même URL entre le jour 60 et le jour 90, le compteur repart à 90 jours depuis la date de la requête. Le champ renewed de la réponse vaut alors true.

Cette fenêtre de renouvellement (J+60 à J+90) permet d'automatiser la prolongation via un cron job ou une tâche planifiée, sans créer de doublons. En dehors de cette fenêtre (avant J+60), la requête retourne simplement le lien existant sans modifier sa date d'expiration.

Limites et rate limiting

L'API applique un rate limiting par adresse IP pour prévenir les abus :

Ces limites s'appliquent à tous les clients, qu'ils utilisent l'interface web ou l'API directement. Il n'existe pas de tier payant avec des limites augmentées.

Exemples d'intégration

Voici des exemples prêts à l'emploi pour les langages les plus courants.

PHP

<?php
$response = file_get_contents('https://www.lejumo.com/api/shorten', false,
  stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Content-Type: application/json\r\n",
    'content' => json_encode(['url' => 'https://www.exemple.fr']),
  ]])
);
$data = json_decode($response, true);
echo $data['short']; // https://lejumo.com/abc123

JavaScript (fetch)

const res = await fetch('https://www.lejumo.com/api/shorten', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ url: 'https://www.exemple.fr' }),
});
const data = await res.json();
console.log(data.short); // https://lejumo.com/abc123

Python

import requests

resp = requests.post(
    'https://www.lejumo.com/api/shorten',
    json={'url': 'https://www.exemple.fr'}
)
data = resp.json()
print(data['short'])  # https://lejumo.com/abc123

Comparatif API raccourcisseur

Lejumo face aux principales API de raccourcissement d'URL disponibles.

Lejumo URLR.me Bitly
Clé API requise ✕ Non Oui Oui
Inscription requise ✕ Non Oui Oui
Prix Gratuit Payant Payant
Endpoint stats ✓ Inclus ✓ Inclus ✓ Inclus
Renouvellement automatique ✓ J+60–J+90 Non Non

Questions fréquentes

L'API raccourcisseur de liens Lejumo est-elle vraiment gratuite ?
Oui, l'API est entièrement gratuite, sans abonnement ni version payante. Elle est accessible sans clé API ni inscription. La seule contrainte est le rate limiting par IP (5 créations par heure) pour prévenir les abus.
Faut-il une clé API pour utiliser l'API raccourcisseur URL gratuit ?
Non. L'API Lejumo n'utilise pas de clé d'authentification. Il suffit d'envoyer une requête POST vers /api/shorten avec un corps JSON contenant le champ url. Aucun en-tête Authorization n'est nécessaire.
Peut-on appeler l'API réducteur d'URL depuis un navigateur (JavaScript côté client) ?
Oui. L'API est configurée avec Access-Control-Allow-Origin: * (CORS ouvert), ce qui permet de l'appeler directement depuis un navigateur via fetch() ou XMLHttpRequest, sans proxy serveur intermédiaire.
Que se passe-t-il si j'envoie la même URL deux fois à l'API url shortener ?
Si vous envoyez la même URL une deuxième fois avant le jour 60, l'API retourne le lien court existant sans modifier sa date d'expiration. Entre le jour 60 et le jour 90, la durée est prolongée de 90 jours supplémentaires et le champ renewed de la réponse vaut true.
Les liens créés via l'API raccourcisseur URL France sont-ils permanents ?
Les liens créés via l'API ont une durée fixe de 90 jours, non permanent. Pour des liens permanents, utilisez l'interface web du raccourcisseur qui propose l'option "Permanent". L'API privilégie la durée de 90 jours avec renouvellement pour les cas d'usage automatisés.
Comment intégrer l'API lien court gratuite dans un script automatisé ?
Ajoutez un appel POST /api/shorten à votre script de déploiement ou à votre cron job. Pour maintenir vos liens actifs, planifiez un rappel entre J+60 et J+90 après la création initiale. Les exemples PHP, JavaScript et Python fournis sur cette page sont directement réutilisables.
L'API expose-t-elle un endpoint pour obtenir les statistiques de clics ?
Oui. GET /api/stats/{code} retourne le nombre de clics enregistrés pour un lien court. Les statistiques sont anonymes : seul le compteur total est accessible, sans données personnelles sur les visiteurs.
Quelle est la différence entre l'API Lejumo et une API raccourcisseur classique comme Bitly ?
La différence principale est l'absence de clé API et d'inscription. Bitly et la plupart des API de raccourcissement exigent la création d'un compte et l'obtention d'un token OAuth ou d'une clé API. Lejumo supprime cette friction : une seule requête HTTP suffit pour créer un lien court, sans aucune configuration préalable.

Pour aller plus loin