GET rendition/…/preferences/tts/…

Retrieves the text-to-speech preferences for a given drill or course for the calling user.

Resource URL

https://www.drillster.com/api/2.1.1/rendition/{drillable}/preferences/tts/{language}

Parameters

Field Type Description
drillable
required		 String The ID of the drill.

Example value: 06dkCv4mDVORJKlnwmyzng
language
required		 String The language code of the voice to convert text to speech. Scheme: ISO 639-1

Example value: en

Response

A 2.1.1 TtsPreferences object, with the text-to-speech preferences.

Example request

GET https://www.drillster.com/api/2.1.1/rendition/06dkCv4mDVORJKlnwmyzng/preferences/tts/es

Response

{
  "language": "es",
  "country": "ES",
  "gender": "MALE",
  "speed": "NORMAL"
}

Error responses

The following error situations are possible:

ID Response code Description
drill_not_found 404 (Not found) Drill does not exist in the system or is not in the repertoire of the requesting account.
language_not_found 404 (Not found) The specified language was not found.
country_not_found 404 (Not found) No country was found to support text-to-speech in the provided language

 

Last updated on