Documentación API

Integra el acortador de URLs ly1.ru en tus aplicaciones con nuestra simple API REST.

🔐 Autenticación requerida

El acceso API requiere autenticación. Inicia sesión con Google para obtener tu clave API. Iniciar sesión

Autenticación

Todas las solicitudes API requieren autenticación usando tu clave API. Inclúyela en el encabezado:

Authorization: Bearer YOUR_API_KEY

O usa el encabezado X-API-Key :

X-API-Key: YOUR_API_KEY

Endpoints

POST /api/v1/shorten

Crear una URL acortada.

Parámetros de solicitud

Parámetro	Tipo	Descripción
url requerido	string	La URL a acortar (debe ser una URL HTTP/HTTPS válida)
custom opcional	string	Alias personalizado (3-32 caracteres alfanuméricos)

Ejemplo de solicitud

# Using curl
curl -X POST https://ly1.ru/api/v1/shorten \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/very/long/url", "custom": "mylink"}'

# Using PHP
$ch = curl_init('https://ly1.ru/api/v1/shorten');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'url' => 'https://example.com/very/long/url',
        'custom' => 'mylink'
    ])
]);
$response = json_decode(curl_exec($ch), true);

Respuesta exitosa (200)

{
  "success": true,
  "data": {
    "code": "mylink",
    "short_url": "https://ly1.ru/mylink",
    "subdomain_url": "https://mylink.ly1.ru",
    "original_url": "https://example.com/very/long/url"
  }
}

Respuesta de error (400/401)

{
  "success": false,
  "error": "Error message here"
}

Códigos de error

Code	Descripción
`400`	Solicitud incorrecta — Parámetros o URL inválidos
`401`	No autorizado — Clave API inválida o faltante
`405`	Método no permitido — Usa POST
`500`	Error interno del servidor

Límites de velocidad

Actualmente no hay límites estrictos, pero sé razonable. Las solicitudes excesivas pueden resultar en bloqueo temporal.