Documentación de la API

Introducción

La API sigue las convenciones REST: recibe JSON o datos de formulario y siempre responde JSON, incluso los errores. Todas las fechas usan ISO 8601 en UTC.

Es de uso libre: puedes acortar enlaces sin registrarte ni enviar token, con una sola petición.

Inicio rápido

1. 1

   Acorta tu primer enlace, sin registro

   Terminal Copiar

   curl -X POST https://cut.conorld.com/api/v1/links \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -d '{"url": "https://conorld.com/una/ruta/muy/larga"}'

2. 2

   Usa la URL corta

   La respuesta incluye short_url, lista para compartir. Guárdala en tu sistema: los enlaces creados sin token no se pueden consultar después.

   Respuesta · 201 Created Copiar

   {
     "data": {
       "code": "k7m2xqp",
       "short_url": "https://cut.conorld.com/k7m2xqp",
       "original_url": "https://conorld.com/una/ruta/muy/larga",
       "title": null,
       "is_active": true,
       "expires_at": null,
       "clicks": 0,
       "last_clicked_at": null,
       "created_at": "2026-09-15T15:04:05+00:00",
       "updated_at": "2026-09-15T15:04:05+00:00"
     }
   }

Autenticación

La API es de uso libre: crear enlaces no requiere cuenta ni token. Los endpoints de gestión (listar, editar, eliminar y estadísticas) están reservados a las cuentas de administración de Conorld.

Los enlaces creados sin token no tienen dueño: no se pueden modificar ni consultar después, así que guarda la short_url de la respuesta.

Si tienes un token de administración, envíalo en la cabecera Authorization.

Authorization: Bearer 1|AbCdEfGhIjKlMnOpQrStUvWxYz0123456789
Accept: application/json

• Un token actúa en nombre del usuario que lo creó y solo accede a sus enlaces.
• Crea un token por proyecto. Así puedes revocar uno sin afectar a los demás.
• Si revocas un token, las peticiones que lo usen empiezan a recibir 401 al instante.

Límites de uso

Sin token se pueden crear hasta 10 enlaces por minuto por IP. Con token, cada cuenta puede hacer hasta 60 peticiones por minuto. Cada respuesta indica cuánto te queda:

{
  "message": "Too Many Attempts."
}

Errores

Los errores usan códigos HTTP estándar y siempre traen un campo message.

En los errores de validación (422), errors lista los mensajes de cada campo:

{
  "message": "Ese alias ya está en uso.",
  "errors": {
    "alias": ["Ese alias ya está en uso."]
  }
}

Ejemplos de integración

Crear un enlace desde distintos lenguajes, sin token.

use Illuminate\Support\Facades\Http;

$shortUrl = Http::acceptJson()
    ->timeout(10)
    ->post('https://cut.conorld.com/api/v1/links', ['url' => $urlLarga])
    ->throw()
    ->json('data.short_url');

$ch = curl_init('https://cut.conorld.com/api/v1/links');

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['url' => $urlLarga]),
]);

$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status !== 201) {
    throw new RuntimeException($body['message'] ?? 'No se pudo acortar el enlace');
}

echo $body['data']['short_url'];

const res = await fetch('https://cut.conorld.com/api/v1/links', {
  method: 'POST',
  headers: {
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ url: urlLarga }),
});

const body = await res.json();
if (!res.ok) throw new Error(body.message);

console.log(body.data.short_url);

import requests

response = requests.post(
    "https://cut.conorld.com/api/v1/links",
    headers={
        "Accept": "application/json",
    },
    json={"url": url_larga},
    timeout=10,
)
response.raise_for_status()

print(response.json()["data"]["short_url"])

Buenas prácticas