Ir al contenido
POST AI agent ready /v1/short-url/create

API de acortador de URL: cree enlaces cortos con seguimiento de clics

Envíe una URL y reciba un enlace acortado con un slug personalizado o generado automáticamente. Los enlaces cortos redirigen a través de 302 y realizan un seguimiento del recuento de clics. Los slugs personalizados admiten letras, números, guiones y guiones bajos. Si ya se ha tomado un slug, la API devuelve un error para que puedas volver a intentarlo con uno diferente.

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

Genere enlaces cortos rastreables para campañas de marketing

Cree un enlace corto personalizado para cada campaña (por ejemplo, /launch-2026). Utilice el punto final de estadísticas para realizar un seguimiento de los clics y medir la participación sin herramientas de análisis externas.

Cree una función de acortamiento de enlaces en su producto SaaS

Permita que sus usuarios creen enlaces cortos de marca desde su aplicación. La API maneja la generación de slugs, la detección de colisiones y el seguimiento de redirecciones, por lo que no es necesario crear esa infraestructura.

Frequently asked questions

¿Caducan los enlaces cortos?
Los enlaces cortos creados a través de la API no tienen una caducidad incorporada. Persisten en el almacenamiento hasta que se eliminan manualmente o se borra el almacenamiento subyacente.
¿Qué pasa si mi babosa personalizada ya está tomada?
La API devuelve un error SLUG_TAKEN. Puede volver a intentarlo con un slug diferente u omitir el campo custom_slug para obtener un slug de 6 caracteres generado automáticamente.
¿Qué personajes están permitidos en slugs personalizados?
Letras (A-Z, a-z), números (0-9), guiones (-) y guiones bajos (_). Cualquier otro carácter provoca un error INVALID_SLUG.
¿Se realiza un seguimiento automático del recuento de clics?
Sí. Cada vez que alguien visita la URL corta, el contador de clics aumenta. Utilice el punto final GET /v1/short-url/{slug}/stats para recuperar el recuento actual.
¿Qué tipo de redirección utiliza la URL corta?
La URL corta devuelve una redirección 302 (temporal). Esto significa que los motores de búsqueda no transferirán el valor del enlace a la URL de destino y usted podrá cambiar el destino más adelante si es necesario.

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