Skip to main content

Primeros pasos

Captura de pantalla síncrona

El endpoint screenshot ejecuta una sesión de navegador y devuelve una imagen codificada en base64 en JSON — ideal para integraciones programáticas y el API Tester.

Trabajos asíncronos

Los endpoints jobs encolan tareas de captura de pantalla y permiten consultar el estado y los resultados — ideal para alto volumen o páginas lentas.

Arquitectura REST

La API de capturas de pantalla web sigue los principios REST, con URLs predecibles orientadas a recursos y códigos de estado HTTP estándar para una integración fluida y manejo de errores.

Seguridad HTTPS

Todas las comunicaciones con la API están protegidas con TLS 1.2 o superior para garantizar la integridad y privacidad de los datos.

Versiones de la API

La API de capturas de pantalla web mantiene la compatibilidad hacia atrás mediante versionado y actualmente opera en la Version 1.

Autenticación

Su clave API es la credencial exclusiva para acceder a la API de capturas de pantalla web. Cada servicio de Cleariflow requiere una clave única. Incluya su clave en el cuerpo JSON como api_key, o como parámetro de consulta para el endpoint GET legacy.

URL base

Renderizado de páginas

Las páginas se renderizan en un navegador headless real. JavaScript se ejecuta completamente antes de capturar la pantalla. La protección SSRF integrada bloquea solicitudes a localhost y rangos de IP privadas.

Códigos de respuesta y error

Cuando las solicitudes fallan, la API devuelve respuestas de error JSON estructuradas con códigos y descripciones específicos para una resolución eficaz de problemas.