Développeurs

API publique

Dernière mise à jour : 21 juin 2026

yrebs expose une petite API HTTP/JSON pour créer des liens raccourcis et consulter des statistiques, sans clé d'API ni inscription. Toutes les réponses sont au format JSON.

Limite de débit : 30 requêtes par minute et par adresse IP, tous endpoints confondus. Au-delà, l'API répond 429 avec {"error": "Trop de requêtes. Attendez une minute."}.

Créer un lien

POST/api/shorten

Raccourcit une URL. Aucune authentification requise pour un usage simple.

curl -X POST https://yrebs.com/api/shorten \
  -H "Content-Type: application/json" \
  -d '{"url": "https://exemple.com/une-page-tres-longue"}'

{
  "short_url":    "https://yrebs.com/aB3xQ",
  "slug":         "aB3xQ",
  "original_url": "https://exemple.com/une-page-tres-longue",
  "expires_at":   null,
  "max_clicks":   null,
  "owner_token":  "•••"
}

Paramètres du corps de la requête (JSON) :

url (requis) — l'URL de destination, doit commencer par http:// ou https://.
custom_slug (optionnel) — slug personnalisé, 3 à 24 caractères (lettres, chiffres, - ou _). Nécessite d'être connecté (cookie de session) ; sans compte, l'API répond 401.
expires_in (optionnel) — nombre de jours avant expiration automatique du lien.
max_clicks (optionnel) — nombre maximum de clics avant désactivation du lien.

Si la requête est anonyme (sans session), la réponse inclut un owner_token : conservez-le, c'est lui qui permettra plus tard de gérer ou supprimer ce lien sans compte.

Statistiques globales

GET/api/stats

Retourne le nombre total de liens créés et de clics enregistrés sur l'ensemble du service.

curl https://yrebs.com/api/stats

{
  "total_links":  18420,
  "total_clicks": 96531
}

Infos publiques d'un lien

GET/api/info/:slug

Retourne les métadonnées publiques d'un lien : date de création, nombre de clics, expiration. L'URL de destination n'est volontairement pas renvoyée, pour empêcher l'énumération de l'espace des slugs et la découverte de liens partagés de façon restreinte.

curl https://yrebs.com/api/info/aB3xQ

{
  "slug":       "aB3xQ",
  "created_at": "2026-06-18T09:12:03",
  "clicks":     42,
  "expires_at": null,
  "max_clicks": null
}

Un slug inexistant ou expiré renvoie 404 avec {"error": "Lien introuvable."}.

Authentification

Les endpoints publics ci-dessus ne nécessitent rien. Les opérations liées à un compte (gestion de vos liens, statistiques détaillées, profil…) utilisent le cookie de session créé à la connexion sur yrebs.com — il n'existe pas encore de jeton d'API séparé pour un usage 100% programmatique de ces fonctionnalités.

Une question, un bug à signaler, ou besoin d'un endpoint qui n'existe pas encore ? Contactez-nous sur Telegram (@yrebs).