Documentación

Cómo ejecutar auditorías, leer informes y compartir resultados.

Esta página explica el uso de Orilyt en términos sencillos. Se centra en la interfaz y la lógica de los informes.

Lee por qué las auditorías automáticas fallan sin contexto →

Esta página explica el uso de Orilyt en términos sencillos. Se centra en la interfaz y la lógica de los informes.

Ejecutar una auditoría

  • Página pública: introduce una URL → se genera un informe público (restringido).
  • Panel de control: introduce una URL → se genera un informe completo y se guarda en tu historial.
Orilyt es de solo lectura. No requiere acceso de administrador y no modifica el sitio auditado.

Panel de control

El panel de control es tu centro de operaciones. Usa una disposición maestro-detalle: tus sitios a la izquierda, el historial de auditorías a la derecha.

Gestión de sitios

  • Añade un sitio introduciendo su URL. Orilyt crea el registro del sitio y ejecuta la primera auditoría automáticamente.
  • Cada tarjeta de sitio muestra el dominio, la última puntuación y la tendencia del score (sube, baja o estable).
  • Busca y filtra sitios por nombre. La paginación gestiona grandes portfolios (20 sitios por página).
  • Desactiva un sitio para liberar un espacio en tu plan. La desactivación también detiene el monitoring.

Historial de auditorías

  • Haz clic en un sitio para ver su historial completo con columnas ordenables (fecha, puntuación global y por sección).
  • Filtra por fecha y ajusta las filas por página (15, 50 o 100). Haz clic en cualquier fila para abrir el informe.
  • Relanza una auditoría en cualquier momento con el botón "Ejecutar auditoría". El progreso se muestra en tiempo real (56 pruebas).

Auditorías multipage

  • Las auditorías multipage recorren varias páginas del mismo sitio (vía sitemap o lista manual) y producen un informe consolidado.
  • Los resultados incluyen puntuaciones globales del sitio, desglose por página y los problemas principales en todas las páginas.

Monitoring

  • Activa el monitoring por sitio (planes de pago). Orilyt verifica SSL, uptime y cambios de puntuación a intervalos regulares.
  • Las alertas aparecen en el panel y se envían por email cuando se detecta un problema.
  • La frecuencia del monitoring depende de tu plan. Desactivar un sitio detiene automáticamente su monitoring.

Créditos

  • Tu saldo de créditos se muestra en la parte superior. Cada auditoría cuesta 1 crédito; las auditorías multipage cuestan más según el número de páginas.
  • Plan gratuito: 20 créditos/mes para 1 sitio. Los planes de pago incluyen créditos mensuales con acumulación.
  • Cuando se agotan los créditos, Orilyt muestra opciones de mejora (cambio de plan o compra de paquete).
Los límites de sitios y las cuotas de créditos dependen de tu plan. Puedes gestionar tu suscripción desde la página de Cuenta.

Informes públicos vs privados

Informe público (restringido)
Muestra la lista de pruebas y puntuaciones, pero oculta el contenido completo de los cajones y el resumen IA largo.
Informe privado (propietario)
Muestra el contenido completo de los cajones (hechos, acciones recomendadas, pasos de verificación) y el resumen IA completo.
En modo público restringido, Orilyt no envía el HTML completo de los cajones al navegador (evita filtraciones vía código fuente/JSON).

Cómo leer el informe

  • Vista de prioridad agrupa los elementos más importantes primero.
  • Vistas por sección (Rendimiento / Seguridad / SEO / UX / Legal) agrupan las pruebas por tema.
  • Los estados se simplifican: OK, A mejorar, Crítico.
Las puntuaciones son indicadores. Usa siempre los pasos de verificación en los cajones después de aplicar los cambios.

Cajones (detalles)

Cada prueba abre un cajón con una estructura fija:

  • Hechos (observados): lo que se midió o detectó.
  • Interpretación: resumen listo para tomar decisiones.
  • Por qué importa: impacto práctico.
  • Qué hacer (recomendado): la corrección.
  • Verificación: cómo confirmar que la corrección funcionó.
Algunos cajones incluyen fragmentos de código (caja negra con botón Copiar). Úsalos tal cual, pero prueba en staging si es posible.

Compartir un informe

  • Solo el propietario del informe (conectado) puede activar, actualizar o desactivar un enlace de compartir.
  • Un enlace compartido abre el informe en modo público restringido.
  • Los clientes pueden ver el informe (solo lectura), pero no acceder al contenido completo de los cajones.
Esto es intencionado: el uso compartido público está pensado para comunicación, no para exponer todos los pasos de remediación técnica.

Exportar PDF

Orilyt genera dos tipos de PDF directamente desde la página del informe — sin necesidad de imprimir desde el navegador.

  • Desde cualquier informe, usa los dos botones PDF en la barra fija: "PDF Cliente" y "PDF Técnico".
  • Ambos modos funcionan para informes de una página y multipage.
  • PDF Cliente: resumen ejecutivo IA, tarjetas de pruebas simplificadas (puntuación + recomendación clave). Ideal para presentar a clientes.
  • PDF Técnico: contenido completo de los cajones (hechos, acciones, verificación), más anexo técnico (PageSpeed, Safe Browsing, info del servidor).
Los ajustes de white-label (logo, colores, nombre de empresa) se aplican automáticamente a las exportaciones PDF.

Cuenta y ajustes

La página de cuenta te permite gestionar tu perfil, suscripción e imagen de marca.

Perfil

  • Consulta y cambia tu dirección de email. Se envía un email de verificación a la nueva dirección antes de activarla.
  • Tu estado de verificación de email se muestra. Las cuentas no verificadas tienen funcionalidades limitadas.

Suscripción y facturación

  • Consulta tu plan actual, su estado y las funciones incluidas (límite de sitios, cuota API, URLs multipage, acceso white-label).
  • Gestiona tu suscripción (mejorar, reducir, cancelar) a través del portal de facturación de Stripe.
  • Desglose del saldo de créditos: tus créditos restantes por origen (gratuito, paquete, suscripción) y próximas expiraciones.

White-label (planes de pago)

  • Activa el white-label para reemplazar la marca Orilyt por la tuya en informes y PDF.
  • Personaliza: nombre de empresa, datos de contacto, colores primario y secundario.
  • Sube tu logo y favicon (PNG, JPG o SVG, máx. 500 KB). Arrastrar y soltar soportado.
  • Añade un texto de pie de página personalizado que aparece en los PDF exportados.
El white-label está disponible solo en planes de pago. Los cambios se aplican a todos los futuros informes y exportaciones PDF.

Códigos promo

  • Introduce un código promo para recibir créditos bonus o un descuento en tu próxima suscripción.

Eliminar cuenta

  • La eliminación de cuenta es permanente. Debes introducir tu contraseña y confirmar. Si tienes una suscripción activa, cancélala primero a través del portal de facturación.

Limitaciones

  • Las auditorías se basan en lo accesible por HTTP en el momento del escaneo (timeouts, WAF, bloqueos pueden afectar los resultados).
  • Algunas pruebas no son medibles en una muestra de página dada (ejemplo: sin imágenes → lazy-loading no puede evaluarse).
  • Las puntuaciones no son garantías. Úsalas para priorizar, luego verifica.

API REST

Orilyt ofrece una API REST que permite ejecutar auditorías y recuperar resultados de forma programática. Útil para agencias, desarrolladores y cualquiera que quiera integrar auditorías web en sus propias herramientas (CRM, dashboards, CI/CD).

Autenticación

Cada solicitud API debe incluir tu clave API. Puedes encontrar y gestionar tus claves en la página de claves API.

Se admiten tres métodos (elige uno):

  • Header (recomendado)
    Authorization: Bearer YOUR_API_KEY
  • Header personalizado
    X-API-Key: YOUR_API_KEY
  • Parámetro URL (menos seguro — visible en logs)
    GET /api_v1.php?url=example.com&key=YOUR_API_KEY

Ejecutar una auditoría

Lanza una nueva auditoría en una URL dada. Cuenta como 1 llamada API en tu cuota mensual.

curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://orilyt.com/api_v1.php?url=example.com"
  • url — La URL del sitio a auditar (obligatorio).

En caso de éxito, la respuesta contiene los resultados completos de la auditoría bajo la clave data, más metadatos.

{ "status": "ok", "data": { /* full audit results */ }, "audit_id": 142, "site_id": 38, "user_id": 12 }

Recuperar una auditoría

Recupera el resultado JSON completo de una auditoría ya ejecutada. Solo lectura, no cuenta en tu cuota API.

curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://orilyt.com/api_v1.php?audit_id=142"
  • audit_id — El identificador numérico de la auditoría (obligatorio). Lo encontrarás en la URL del informe o en la respuesta de una solicitud de ejecución.
Solo puedes recuperar auditorías que pertenezcan a tu cuenta.

Códigos de error

Todos los errores devuelven un objeto JSON con los campos status, code y error.

HTTPCodeDescription
400missing_urlParámetro faltante o inválido (ej: no se proporcionó URL).
401auth_requiredClave API faltante o inválida.
403audit_forbiddenClave válida pero sin permiso (propietario incorrecto, o plan sin acceso API).
404audit_not_foundAuditoría no encontrada.
429rate_limitedLímite de solicitudes excedido (demasiadas solicitudes por minuto).

Cuotas por plan

Cada plan incluye una cuota mensual de llamadas API. Las auditorías web (panel de control) son ilimitadas en los planes de pago y no consumen llamadas API.

Plan Sitios Llamadas API / mes Acceso API Claves API
Free 1 0 No 0
Solo — 39 € 3 50 2
Pro — 99 € 10 200 5
Business — 199 € 30 500 10
Agency — 449 € 100 2.000 20

Ejemplo completo

Ejecuta una auditoría y luego recupérala más tarde:

# 1. Run an audit curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://orilyt.com/api_v1.php?url=example.com" # Response includes audit_id (e.g. 142) # 2. Retrieve the same audit later curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://orilyt.com/api_v1.php?audit_id=142"

Glosario

Cajón
Un panel de detalle para una prueba específica.
Público restringido
Modo de informe público que oculta los detalles completos para evitar filtraciones de datos.
Verificación
Pasos para confirmar que una corrección funcionó (headers, redirecciones, salida HTML, etc.).
Escaneo de solo lectura
La auditoría no modifica el sitio objetivo y no requiere acceso de administrador.