KUTAE
by
SOFTWATOOLS
Nuestra URL Shortener API te permite crear, personalizar y analizar enlaces cortos de forma programática, con métricas avanzadas y control total.
La URL Shortener API de Kutae es un conjunto de endpoints RESTful que permite a desarrolladores programáticamente:
Enlaces limpios y legibles que refuerzan tu marca.
Métricas en tiempo real: clics, geolocalización y dispositivo.
Define expiración y protección con contraseña por enlace.
Soporta miles de peticiones por hora con alta disponibilidad.
Integra parámetros UTM automáticamente y mide el ROI de campañas.
Envía enlaces cortos desde bots en WhatsApp, Telegram y SMS.
Extrae datos JSON para tus dashboards de Business Intelligence.
Genera códigos QR con un solo endpoint para ferias y flyers.
Nuestra API distingue entre:
create, info, stats sin token.list, update, delete con token.Para usar los endpoints protegidos, añade en la cabecera:
Authorization: Bearer <TU_TOKEN_API>Obtén tu token tras actualizar a Premium/Enterprise.
Crea una nueva URL corta.
Request JSON:
{
"url": "https://tusitio.com/pagina-larga",
"custom_code": "mi-alias",
"expiration": 14,
"password_protected": 1,
"password": "secreto",
"utm_source": "newsletter",
"utm_medium": "email"
}Response JSON:
{
"success": true,
"data": {"short_url": "https://kutae.com/mi-alias", "expires_at": "2025-05-06T12:00:00Z"}
}Obtiene detalles de una URL corta.
GET /api.php?route=info&code=mi-alias{
"success": true,
"data": {"original_url": "https://tusitio.com/pagina-larga","created_at":"2025-04-22T08:00:00Z","clicks":123}
}Recupera métricas detalladas por período.
GET /api.php?route=stats&code=mi-alias&timeframe=30days{ "success":true, "data": { "clicks": 256, "countries": [...], "devices": [...] } }Lista tus URLs acortadas.
Authorization: Bearer <token>{ "success":true, "data":[...urls...] }Modifica una URL existente.
{ "id": 456, "custom_code": "nuevo-alias", "is_active": true }{ "success":true, "message":"URL actualizada" }Desactiva (elimina) una URL.
{ "id": 456 }{ "success":true, "message":"URL eliminada" }curl -X POST https://kutae.com/api.php?route=create \
-H "Content-Type: application/json" \
-d '{"url":"https://tusitio.com/extra-larga","custom_code":"alias"}'fetch('https://kutae.com/api.php?route=create', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ url: 'https://tusitio.com/extra-larga', custom_code: 'alias' })
})
.then(res =》 res.json())
.then(data =》 console.log(data));import requests
resp = requests.post(
'https://kutae.com/api.php?route=create',
json={ 'url':'https://tusitio.com/extra-larga','custom_code':'alias' }
)
print(resp.json())$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://kutae.com/api.php?route=create');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['url'=>'https://tusitio.com/extra-larga','custom_code'=>'alias']));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;| Término | Descripción |
|---|---|
| UTM | Parámetros para etiquetar campañas de marketing. |
| Redirección 301 | Redirección permanente que conserva SEO. |
| Código HTTP 429 | Límite de peticiones excedido. |
| Código personalizado | Alias definido por el usuario. |
| Código | HTTP | Significado |
|---|---|---|
| 1001 | 400 | URL inválida |
| 1002 | 409 | Código personalizado ya existe |
| 1003 | 401 | Autenticación requerida |
| 1004 | 404 | Recurso no encontrado |
| 1005 | 429 | Límite de peticiones alcanzado |
Para evitar abuso, aplicamos rate limits:
En caso de 429, inspecciona cabecera Retry-After e implementa reintentos.
success y maneja mensajes de error.v1; mantente al día con el changelog.Regístrate, obtén tu token y realiza tu primera petición create.
En el panel de usuario, sección 'API Keys'.
Sí, desde la misma sección puedes generar y revocar claves.
Consulta la cabecera Retry-After e implementa un retardo en tus reintentos.