Reports
A Report represents a validation report you've created in Rocket Validator. Contains a list of web pages that were found from the starting url, and the HTML and accessibility issues that were found.
Attributes
- ID
- Unique report 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.
- Max Pages
- Maximum number of web pages to include. Places a limit on the Spider.
- Num Pages
- Actual number of web pages included in the report found by the Spider.
- Rate Limit
- Maximum allowed requests per second.
- Perform HTML Checks
- Boolean to indicate whether or not HTML checks will be included.
- Perform A11Y Checks
- Boolean to indicate whether or not accessibility checks will be included.
- Checks
-
Details for the checks enabled for this report.
- HTML
-
Details for the HTML checks, if enabled (
null
otherwise).- Status
- HTML checks status, showing the number of checks
pending
,checked
andfailed
. - Issues
- Counters for the number of HTML errors, warnings, muted errors and muted warnings. This sums the number of HTML issues on the web pages for a particular report.
- A11Y
-
Details for the Accessibility checks, if enabled (
null
otherwise).- Status
- Accessibility checks status, showing the number of checks
pending
,checked
andfailed
. - Issues
- Counters for the number of Accessibility errors, warnings, muted errors and muted warnings. This sums the number of Accessibility issues on the web pages for a particular report.
- Inserted At
- Timestamp when the report was created.
- Updated At
- Timestamp when the report was last updated.
Relationships
- Web Pages
- The list of web pages found by the Spider for that report.
- Common A11Y issues
- The accessibility issues found on the web pages for that report, if any, grouped together by their kind.
- Common HTML issues
- The HTML issues found on the web pages for that report, if any, grouped together by their kind.
- Schedule
- The Scheduled Report that initiated this Report, if any.
Example
Example: Report example
{
"data": {
"attributes": {
"checks": {
"a11y": {
"issues": {
"errors": 60,
"muted_errors": 0,
"muted_warnings": 0,
"warnings": 0
},
"status": {
"checked": 10,
"failed": 0,
"pending": 0
}
},
"html": {
"issues": {
"errors": 157,
"muted_errors": 0,
"muted_warnings": 0,
"warnings": 20
},
"status": {
"checked": 10,
"failed": 0,
"pending": 0
}
}
},
"id": "850e9a7c-66d6-4178-ae15-9abb49fc0b38",
"inserted_at": "2020-05-12T17:09:43",
"max_pages": 10,
"num_pages": 10,
"perform_a11y_checks": true,
"perform_html_checks": true,
"rate_limit": 3,
"starting_url": "http://validationhell.com/",
"updated_at": "2020-05-12T17:09:43"
},
"id": "850e9a7c-66d6-4178-ae15-9abb49fc0b38",
"relationships": {
"common_a11y_issues": {
"links": {
"related": "https://rocketvalidator.dev/api/v0/reports/850e9a7c-66d6-4178-ae15-9abb49fc0b38/common_a11y_issues"
}
},
"common_html_issues": {
"links": {
"related": "https://rocketvalidator.dev/api/v0/reports/850e9a7c-66d6-4178-ae15-9abb49fc0b38/common_html_issues"
}
},
"schedule": {
"links": {
"related": null
}
},
"web_pages": {
"links": {
"related": "https://rocketvalidator.dev/api/v0/reports/850e9a7c-66d6-4178-ae15-9abb49fc0b38/web_pages"
}
}
},
"type": "report"
},
"jsonapi": {
"version": "1.0"
}
}
Create a Report
To create a Report, send a POST
request to /api/v0/reports
, with a JSON payload in the body including the attributes:
starting_url
. The initial URL where the Spider will start on.max_pages
. The Spider will recursively follow internal links found until this limit is reached.rate_limit
. Limit on the number of requests per second.perform_html_checks
. Boolean to enable checks using the W3C Validator software on the Web Pages found.perform_a1yy_checks
. Boolean to enable checks using Deque Axe Core software on the Web Pages found.
The next example shows how to form the body payload with the Report attributes.
Example: POST https://rocketvalidator.dev/api/v0/reports
{
"data": {
"attributes": {
"starting_url": "http://validationhell.com",
"max_pages": 100,
"rate_limit": 3,
"perform_html_checks": true,
"perform_a11y_checks": true
}
}
}
Rocket Validator will return the created Report with a status of a 201 Created
, and will start scanning the Web Pages found. You can then refresh the Report by its ID (see Retrieve a Report) to check the progress of the Report, including the checks status, pending count and issues found.
If the Report can't be created, a 422 Unprocessable Entity
status will be returned, containing details about the the errors found.
Example: POST https://rocketvalidator.dev/api/v0/reports
{
"errors": [{
"detail": "Starting url has invalid format",
"source": {
"pointer": "/data/attributes/starting_url"
},
"title": "has invalid format"
}],
"jsonapi": {
"version": "1.0"
}
}
Retrieve a Report
To show an individual Report, send a GET
request to /api/v0/reports/$REPORT_ID
.
Example: GET https://rocketvalidator.dev/api/v0/reports/$REPORT_ID
{
"data": {
"attributes": {
"checks": {
"a11y": {
"issues": {
"errors": 60,
"muted_errors": 0,
"muted_warnings": 0,
"warnings": 0
},
"status": {
"checked": 10,
"failed": 0,
"pending": 0
}
},
"html": {
"issues": {
"errors": 157,
"muted_errors": 0,
"muted_warnings": 0,
"warnings": 20
},
"status": {
"checked": 10,
"failed": 0,
"pending": 0
}
}
},
"id": "850e9a7c-66d6-4178-ae15-9abb49fc0b38",
"inserted_at": "2020-05-12T17:09:43",
"max_pages": 10,
"num_pages": 10,
"perform_a11y_checks": true,
"perform_html_checks": true,
"rate_limit": 3,
"starting_url": "http://validationhell.com/",
"updated_at": "2020-05-12T17:09:43"
},
"id": "850e9a7c-66d6-4178-ae15-9abb49fc0b38",
"relationships": {
"common_a11y_issues": {
"links": {
"related": "https://rocketvalidator.dev/api/v0/reports/850e9a7c-66d6-4178-ae15-9abb49fc0b38/common_a11y_issues"
}
},
"common_html_issues": {
"links": {
"related": "https://rocketvalidator.dev/api/v0/reports/850e9a7c-66d6-4178-ae15-9abb49fc0b38/common_html_issues"
}
},
"schedule": {
"links": {
"related": null
}
},
"web_pages": {
"links": {
"related": "https://rocketvalidator.dev/api/v0/reports/850e9a7c-66d6-4178-ae15-9abb49fc0b38/web_pages"
}
}
},
"type": "report"
},
"jsonapi": {
"version": "1.0"
}
}
List your Reports
To list all Reports in your account, send a GET
request to /api/v0/reports
.
Example: GET https://rocketvalidator.dev/api/v0/reports/
{
"data": [
{
"attributes": {
"checks": {
"a11y": {
"issues": {
"errors": 60,
"muted_errors": 0,
"muted_warnings": 0,
"warnings": 0
},
"status": {
"checked": 10,
"failed": 0,
"pending": 0
}
},
"html": {
"issues": {
"errors": 157,
"muted_errors": 0,
"muted_warnings": 0,
"warnings": 20
},
"status": {
"checked": 10,
"failed": 0,
"pending": 0
}
}
},
"id": "850e9a7c-66d6-4178-ae15-9abb49fc0b38",
"inserted_at": "2020-05-12T17:09:43",
"max_pages": 10,
"num_pages": 10,
"perform_a11y_checks": true,
"perform_html_checks": true,
"rate_limit": 3,
"starting_url": "http://validationhell.com/",
"updated_at": "2020-05-12T17:09:43"
},
"id": "850e9a7c-66d6-4178-ae15-9abb49fc0b38",
"relationships": {
"common_a11y_issues": {
"links": {
"related": "https://rocketvalidator.dev/api/v0/reports/850e9a7c-66d6-4178-ae15-9abb49fc0b38/common_a11y_issues"
}
},
"common_html_issues": {
"links": {
"related": "https://rocketvalidator.dev/api/v0/reports/850e9a7c-66d6-4178-ae15-9abb49fc0b38/common_html_issues"
}
},
"schedule": {
"links": {
"related": null
}
},
"web_pages": {
"links": {
"related": "https://rocketvalidator.dev/api/v0/reports/850e9a7c-66d6-4178-ae15-9abb49fc0b38/web_pages"
}
}
},
"type": "report"
}
],
"jsonapi": {
"version": "1.0"
},
"links": {
"last": "https://rocketvalidator.dev/api/v0/reports/?page[number]=50&page[size]=25",
"next": "https://rocketvalidator.dev/api/v0/reports/?page[number]=2&page[size]=25",
"self": "https://rocketvalidator.dev/api/v0/reports/?page[number]=1&page[size]=25"
}
}
Delete a Report
To delete an individual Report from your account, send a DELETE
request to /api/v0/reports/$REPORT_ID
.
Example: DELETE https://rocketvalidator.dev/api/v0/reports/$REPORT_ID
204 No Content