Skip to content

Schedules

A Schedule represents a programmed report that will be run on a given periodicity, or after a deploy webhook is received.

Think of a Scheduled Report as a regular Report, that can be set to run automatically on a defined schedule or via deploy hooks.

Attributes

ID
Unique schedule ID.
Starting URL
Initial URL, that the Spider will use as the initial request. The Spider will include the internal links from that starting URL, and then recursively include the linked web pages from those, until the Max Pages limit is reached.
Perform A11Y Checks
Boolean to indicate whether or not accessibility checks will be included.
Perform HTML Checks
Boolean to indicate whether or not HTML checks will be included.
Max Pages
Maximum number of web pages to include. Places a limit on the Spider.
Periodicity
Shows when the schedule will be run, using the keys every, which can be one of day / week / month. If week is used, then weekday will indicate the week day the schedule is run. If month is used, the field monthday will give the details for the day of the month the schedule will be run on. If this field is null, the schedule will never be run, except through deploy hooks.
Rate Limit
Maximum allowed requests per second.
Active
Boolean to enable or disable the schedule. Only active ones will be run.
Inserted At
Timestamp when the schedule was created.
Updated At
Timestamp when the schedule was last updated.
Last Fired At
Timestamp when the schedule was last run.

Example

Example: Schedule example

{
    "data": {
        "attributes": {
            "active": true,
            "perform_a11y_checks": true,
            "perform_html_checks": true,
            "id": "d2e1f",
            "inserted_at": "2020-02-28T13:01:23",
            "last_fired_at": "2020-02-28T13:01:30",
            "max_pages": 10,
            "periodicity": {
                "every": "month",
                "monthday": 15
            },
            "rate_limit": 5,
            "starting_url": "http://validationhell.com/",
            "updated_at": "2020-02-28T13:01:30"
        },
        "id": "d2e1f",
        "relationships": {
            "reports": {
                "links": {
                "related": "https://rocketvalidator.dev/api/v0/reports?filter[schedule_id]=d2e1f"
                }
            }
            },
        "type": "schedule"
    },
    "jsonapi": {
        "version": "1.0"
    }
}

List your Schedules

To list all Schedules in your account, send a GET request to /api/v0/schedules.

Example: GET https://rocketvalidator.dev/api/v0/schedules

{
    "data": [
        {
        "attributes": {
            "active": true,
            "perform_a11y_checks": true,
            "perform_html_checks": true,
            "id": "9c55",
            "inserted_at": "2019-02-05T13:13:29",
            "last_fired_at": "2020-04-28T12:02:57",
            "max_pages": 10,
            "periodicity": {
            "every": "month",
            "monthday": 23
            },
            "rate_limit": 3,
            "starting_url": "http://validationhell.com",
            "updated_at": "2020-04-28T12:02:57"
        },
        "id": "9c55",
        "relationships": {
            "reports": {
            "links": {
                "related": "https://rocketvalidator.dev/api/v0/reports?filter[schedule_id]=9c55"
            }
            }
        },
        "type": "schedule"
        }
    ],
    "jsonapi": {
        "version": "1.0"
    },
    "links": {
        "last": "https://rocketvalidator.dev/api/v0/schedules?page[number]=7&page[size]=25",
        "next": "https://rocketvalidator.dev/api/v0/schedules?page[number]=2&page[size]=25",
        "self": "https://rocketvalidator.dev/api/v0/schedules?page[number]=1&page[size]=25"
    }
}

Retrieve a Schedule

To retrieve an individual Schedule in your account, send a GET request to /api/v0/schedules/$SCHEDULE_ID.

Example: GET https://rocketvalidator.dev/api/v0/schedules/$SCHEDULE_ID

{
    "data": {
        "attributes": {
        "active": true,
        "perform_a11y_checks": true,
        "perform_html_checks": true,
        "id": "9c55",
        "inserted_at": "2019-02-05T13:13:29",
        "last_fired_at": "2020-04-28T12:02:57",
        "max_pages": 10,
        "periodicity": {
            "every": "month",
            "monthday": 23
        },
        "rate_limit": 3,
        "starting_url": "http://validationhell.com",
        "updated_at": "2020-04-28T12:02:57"
        },
        "id": "9c55",
        "relationships": {
        "reports": {
            "links": {
            "related": "https://rocketvalidator.dev/api/v0/reports?filter[schedule_id]=9c55"
            }
        }
        },
        "type": "schedule"
    },
    "jsonapi": {
        "version": "1.0"
    }
}

Filter Reports by Schedule

To list all the Reports in your account that have been run via a given Schedule, send a GET request /api/v0/reports?filter[schedule_id]=$SCHEDULE_ID.

This will list your Reports, filtered by that schedule id.

Example: GET https://rocketvalidator.dev/api/v0/reports?filter[schedule_id]=$SCHEDULE_ID

{
    "data": [
        {
            "attributes": {
                "id": "ce472",
                "inserted_at": "2020-04-28T12:02:57",
                "max_pages": 10,
                "num_pages": 10,
                "rate_limit": 3,
                "starting_url": "http://validationhell.com/",
                "total_a11y_issues": {
                    "errors": 38,
                    "muted_errors": 0,
                    "muted_warnings": 0,
                    "warnings": 3
                },
                "total_html_issues": {
                    "errors": 649,
                    "muted_errors": 0,
                    "muted_warnings": 0,
                    "warnings": 434
                },
                "updated_at": "2020-04-28T12:02:57"
            },
            "id": "ce472",
            "relationships": {
                "common_a11y_issues": {
                    "links": {
                        "related": "https://rocketvalidator.dev/api/v0/reports/ce472/common_a11y_issues"
                    }
                },
                "common_html_issues": {
                    "links": {
                        "related": "https://rocketvalidator.dev/api/v0/reports/ce472/common_html_issues"
                    }
                },
                "schedule": {
                    "links": {
                        "related": "https://rocketvalidator.dev/api/v0/schedules/9c552164-1ea6-4664-96c4-7b8f48476d83"
                    }
                },
                "web_pages": {
                    "links": {
                        "related": "https://rocketvalidator.dev/api/v0/reports/ce472/web_pages"
                    }
                }
            },
            "type": "report"
        }
    ],
    "jsonapi": {
        "version": "1.0"
    },
    "links": {
        "self": "https://rocketvalidator.dev/api/v0/reports?filter[schedule_id]=9c552164-1ea6-4664-96c4-7b8f48476d83&page[number]=1&page[size]=25"
    }
}