Aller au contenu
POST AI agent ready /v1/short-url/create

API URL Shortener - Créez des liens courts avec le suivi des clics

Soumettez une URL et recevez un lien raccourci avec un slug généré automatiquement ou personnalisé. Les liens courts redirigent via 302 et suivent le nombre de clics. Les slugs personnalisés prennent en charge les lettres, les chiffres, les traits d’union et les traits de soulignement. Si un slug est déjà pris, l'API renvoie une erreur afin que vous puissiez réessayer avec un autre.

Parameters

stringrequired

The target URL to shorten. Must be a valid http or https URL.

string

An optional custom slug for the short URL. Letters, numbers, hyphens, and underscores only.

Code examples

curl -X POST https://api.botoi.com/v1/short-url/create \
  -H "Content-Type: application/json" \
  -d '{"url":"https://docs.botoi.com/getting-started","custom_slug":"getting-started"}'

When to use this API

Générez des liens courts traçables pour les campagnes marketing

Créez un lien court slug personnalisé pour chaque campagne (par exemple, /launch-2026). Utilisez le point de terminaison des statistiques pour suivre les clics et mesurer l'engagement sans outils d'analyse externes.

Créez une fonctionnalité de raccourcissement de lien dans votre produit SaaS

Laissez vos utilisateurs créer des liens courts de marque à partir de votre application. L'API gère la génération de slugs, la détection de collisions et le suivi des redirections, vous n'avez donc pas besoin de créer cette infrastructure.

Frequently asked questions

Les liens courts expirent-ils ?
Les liens courts créés via l'API n'ont pas de date d'expiration intégrée. Ils persistent dans le stockage jusqu'à ce qu'ils soient supprimés manuellement ou que le stockage sous-jacent soit effacé.
Que se passe-t-il si mon slug personnalisé est déjà pris ?
L'API renvoie une erreur SLUG_TAKEN. Vous pouvez réessayer avec un autre slug ou omettre le champ custom_slug pour obtenir un slug à 6 caractères généré automatiquement.
Quels caractères sont autorisés dans les slugs personnalisés ?
Lettres (A-Z, a-z), chiffres (0-9), traits d'union (-) et traits de soulignement (_). Tout autre caractère provoque une erreur INVALID_SLUG.
Le nombre de clics est-il suivi automatiquement ?
Oui. Chaque fois que quelqu'un visite l'URL courte, le compteur de clics augmente. Utilisez le point de terminaison GET /v1/short-url/{slug}/stats pour récupérer le décompte actuel.
Quel type de redirection l'URL courte utilise-t-elle ?
L'URL courte renvoie une redirection 302 (temporaire). Cela signifie que les moteurs de recherche ne transféreront pas l’équité des liens vers l’URL cible et que vous pourrez modifier la destination ultérieurement si nécessaire.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs