Documentación API

Autenticación HTTP Basic · Respuestas XML · REST

Inicia sesión para ver tus credenciales API y probar los endpoints directamente desde esta página.

Iniciar sesión

Autenticación

Todas las solicitudes usan autenticación HTTP Basic (RFC 7617). Pasa tu login y contraseña API en el encabezado Authorization.

curl -u "API_IDENTIFIER:API_SECRET_KEY" \
     https://dev.webcron.org/cron.get

Endpoints

GET /time — Verificar conexión

Verifica que las credenciales son válidas y el servicio está disponible.

Respuesta

<?xml version="1.0"?>
<rsp status="ok" timestamp="1745234567"/>
GET /cron.get — Listar cronjobs

Devuelve tus cronjobs con paginación.

Parámetros

Nombre Tipo Predeterminado Description
page int 1 Número de página
perpage int 100 Resultados por página (máx. 100)

Respuesta

<?xml version="1.0"?>
<rsp status="ok" total="3">
  <cron id="42" name="My job" url="https://example.com/run"
        status="1" time_out="30" one_off="0">
    <time minute="*/5" hour="*" day="*" weekday="*" month="*"/>
  </cron>
</rsp>
POST /cron.add — Crear un cronjob

Crea un nuevo cronjob.

Parámetros

Nombre Tipo Predeterminado Description
name * string — Nombre del cronjob
url * string — URL a llamar
minute string * Expresión cron — minuto
hour string * Expresión cron — hora
day string * Expresión cron — día del mes
weekday string * Expresión cron — día de la semana (0-6)
month string * Expresión cron — mes
time_out int 30 Timeout en segundos (30, 180, 600, 1800, 3600)

Respuesta

<?xml version="1.0"?>
<rsp status="ok" id="43"/>
POST /cron.edit — Editar un cronjob

Actualiza los campos proporcionados de un cronjob existente.

Parámetros

Nombre Tipo Predeterminado Description
id * int — ID del cronjob
name string — Nuevo nombre
url string — Nueva URL
status int — Activar (1) o desactivar (0)
minute,hour,day,weekday,month string — Campos de planificación

Respuesta

<?xml version="1.0"?>
<rsp status="ok"/>
POST /cron.delete — Eliminar un cronjob

Elimina permanentemente un cronjob.

Parámetros

Nombre Tipo Predeterminado Description
id * int — ID del cronjob

Respuesta

<?xml version="1.0"?>
<rsp status="ok"/>
POST /cron.state — Activar / Desactivar

Cambia el estado de activación de un cronjob.

Parámetros

Nombre Tipo Predeterminado Description
id * int — ID del cronjob
status * int — 1 = activo, 0 = inactivo

Respuesta

<?xml version="1.0"?>
<rsp status="ok"/>
GET /cron.logs — Historial de ejecuciones

Devuelve las últimas ejecuciones de un cronjob.

Parámetros

Nombre Tipo Predeterminado Description
id * int — ID del cronjob
perpage int 50 Número de entradas de log a devolver

Respuesta

<?xml version="1.0"?>
<rsp status="ok">
  <logs>
    <log date="2026-04-21 10:00:00" http_code="200" total_time="0.342"/>
    <log date="2026-04-21 09:00:00" http_code="200" total_time="0.298"/>
  </logs>
</rsp>

Respuestas de error

En caso de error, el estado HTTP es 4xx y el cuerpo XML contiene el detalle.

<?xml version="1.0"?>
<rsp status="error" error="Cron not found"/>