[{"label":"Latest (1.0.0)","version":"latest"}]
crest

Cc And Transcript

Description

This API’s task is to check for missing captions or transcripts associated with embedded videos and audio files on a webpage. It covers the following Issue IDs:

Issue ID: cr_transcript_missing

Definition

Audio-only content such as podcasts and audio recordings of speeches and press conferences are not made available by transcript.

User Impact

When transcripts are provided for audio-only content, people who are deaf or deaf-blind will have access to the information visually or through the use of electronic braille.

Recommendation

Provide a transcript for audio-only content.

Success Criterion

1.2.1 Prerecorded Audio-only and Video-only (Level A)

Related Success Criteria (if applicable):

1.2.3 Audio Description or Media Alternative (Prerecorded) (Level A)

More details can be found at Understanding Success Criterion 1.2.1.

Issue ID: cr_captions_missing

Definition

Synchronized captions are not provided for video or other multimedia content that contains audio.

User Impact

Users who are deaf or hard of hearing will not have access to important information conveyed in audio. Captions also provide an enhanced experience for users with cognitive differences such as ADHD or learning disabilities. Additionally, captions are useful in certain situations such as environments with loud background noise or situations where sound is not allowed (e.g. the library without headphones, or near a sleeping baby).

Recommendation

Provide captions for all important audio information in video and multimedia content.

Success Criterion

1.2.2 Captions (Prerecorded) (Level A)

Related Success Criteria (if applicable):

2.2.2 Pause, Stop, Hide (Level A)
1.1.1 Non-text Content (Level A)

More details can be found at Understanding Success Criterion 1.2.2.

Request

Request

URL

URL


post
http://{api_host}/crest/api/perceivable/cc-transcript
Copy

Request Body

Request Body

request_body of mimetype application/json Required
Response

Response

Response Body

Response Body

200 OK

Returns CcTranscriptSuccessResponse of type application/json

The Success response contains categories that aggregate all the Error and Alert related issues.

{
	"categories": {
		"error": {
			"count": 2,
			"description": "Errors",
			"items": {
				"cr_captions_missing": {
					"count": 1,
					"description": "Captions missing",
					"id": "cr_captions_missing",
					"level": "A"
				},
				"cr_transcript_missing": {
					"count": 1,
					"description": "Podcast transcript missing",
					"id": "cr_transcript_missing",
					"level": "A"
				}
			}
		}
	},
	"statistics": {
		"allitemcount": 2,
		"pageurl": "http://www.abc.com",
		"time": 5.13,
		"totalaudios": 1,
		"totalelements": 2,
		"totalvideos": 1
	},
	"status": {
		"httpstatuscode": 200,
		"success": "True"
	}
}
Errors

Errors

failure_response
400

Bad Request, missing something, or the request body wasn’t correct.

Code Samples

Code Samples

cURL Command

curl -X POST -H "Content-Type: application/json" -d '{"reporttype":3,"url":"http://www.abc.com"}' http://{api_host}/crest/api/perceivable/cc-transcript


[{"label":"Latest (1.0.0)","version":"latest"}]
crest
Feedback

Was this page helpful?