Referencia de la API

Nayalink ofrece una API REST totalmente tipada. Todo lo que puedes hacer en el panel — crear enlaces cortos, gestionar campañas y etiquetas y leer analíticas de clics respetuosas con la privacidad — está disponible de forma programática.

Para obtener una referencia interactiva donde puedes probar solicitudes en el navegador, abre la referencia interactiva de la API. El contrato legible por máquina es el documento OpenAPI.

URL base

Todos los endpoints se sirven desde https://api.nayalink.co.

Autenticación

Autentícate con una clave de API enviada como token Bearer:

Authorization: Bearer <your-api-key>

Las claves de API están disponibles en los planes Pro y Business y pueden limitarse a permisos específicos. Gestiónalas en Configuración → Tokens de API.

Crear un enlace corto

Solo se requiere original_url:

curl -X POST https://api.nayalink.co/api/v1/links \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"original_url": "https://example.com/very/long/url"}'

La respuesta contiene el código corto generado y la URL corta completa.

Recursos

• Enlaces — crea, actualiza y gestiona enlaces cortos: códigos personalizados, caducidad, protección con contraseña y reglas de enrutamiento.
• Campañas — agrupa enlaces en campañas y consolida sus analíticas.
• Etiquetas — organiza los enlaces con etiquetas codificadas por colores.
• Analytics — lee analíticas de clics agregadas y respetuosas con la privacidad: visitas a lo largo del tiempo, países, ciudades, referentes, navegadores, sistemas operativos, tipos de dispositivo, idiomas y parámetros UTM. No se almacena ninguna dirección IP.
• Tokens de API — crea y revoca claves de API con ámbito limitado.
• Perfil — lee y actualiza la cuenta autenticada.

Próximos pasos

• Prueba solicitudes de forma interactiva en la referencia de la API.
• ¿Nuevo en Nayalink? Empieza por la introducción.