API Raccourcisseur gratuite

Deux endpoints, une clé gratuite

L'API Lejumo requiert une clé API gratuite à envoyer dans l'en-tête Authorization: Bearer. Obtenez votre clé ici — confirmez simplement votre email, sans carte bancaire. 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" \
  -H "Authorization: Bearer VOTRE_CLE_API" \
  -d '{"url":"https://www.exemple.fr"}'

# Réponse 200
{
  "short":      "https://lejumo.com/abc",
  "code":       "abc",
  "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/abc

# Réponse 200
{
  "code":       "abc",
  "short":      "https://lejumo.com/abc",
  "clicks":     42,
  "created_at": 1781191498,
  "expires_at": 1788967498
}

# 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 les mêmes limites que l'interface web :

• Débit (POST /api/shorten) : 60 requêtes par heure par clé API
• Total : 200 liens par clé API. Quand cette limite est atteinte, le lien le plus ancien est automatiquement remplacé par le nouveau — aucune requête n'est rejetée.
• Statistiques (GET /api/stats/{code}) : sans authentification requise, 60 requêtes par heure par IP
• En cas de dépassement du débit, l'API retourne un code HTTP 429 avec un champ retry_after (secondes avant de pouvoir réessayer)

Il n'existe pas de tier payant avec des limites augmentées. Pour des besoins spécifiques, contactez-nous.

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\nAuthorization: Bearer VOTRE_CLE_API\r\n",
    'content' => json_encode(['url' => 'https://www.exemple.fr']),
  ]])
);
$data = json_decode($response, true);
echo $data['short']; // https://lejumo.com/abc

JavaScript (fetch)

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

Python

import requests

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

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. Une clé API gratuite est requise — obtenez la vôtre ici en confirmant votre email. La seule contrainte d'usage est 60 créations par heure par clé.

Faut-il une clé API pour utiliser l'API raccourcisseur URL gratuit ?

Oui. Une clé API gratuite est nécessaire. Inscrivez-vous ici — saisissez votre email, décrivez votre usage, résolvez un calcul rapide, puis confirmez votre email. Votre clé arrive par email en quelques secondes. Transmettez-la via Authorization: Bearer VOTRE_CLE dans chaque requête.

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 la simplicité et le coût. Bitly et la plupart des API de raccourcissement exigent un compte payant et un flux OAuth complexe. Lejumo ne requiert qu'une clé gratuite obtenue en confirmant son email — sans carte bancaire, sans abonnement.