Skip to main content

GET Audio Player HTML Page with Ad Schedule

Overview


The following table contains important information about the GET method in regards to receiving the audio player HTML page with a specific ad schedule.

GET Audio Player HTML Page with Ad Schedule
MethodGET
URL or Endpoint/audio-player/playerId/audioId/adScheduleId.html
HeadersNot Applicable
ParametersplayerId, audioId, adScheduleId, startEpisode
BodyNot Applicable

The description of the URL parameters is as follows:

URL Parameter NameMandatoryTypeDescription
playerIdYesstringUnique Id of the audio player.
audioIdYesstringUnique Id of the audio.
adScheduleIdYesstringUnique Id of the ad schedule to use for advertising.
startEpisodeNostring (query)The episode to start playback from (used for podcasts).

Request Body

The request does not contain a request body

Response

Returns text/html content containing a full HTML page with the embedded audio player, configured with the specified ad schedule. The page structure is the same as GET Audio Player HTML Page, with the player script URL including the ad schedule id:

https://vp.gjirafa.net/audio-player/{playerId}/{audioId}/{adScheduleId}.js

If the action is successful, the service sends back an HTTP 200 or 201 response.

Errors

For information about the errors that are common to all actions, see Common Errors:

  • HTTP Status Code 400: Bad Request

  • HTTP Status Code 401: Unauthorized

  • HTTP Status Code 403: Forbidden

  • HTTP Status Code 404: Result Not Found

  • HTTP Status Code 500: Internal Server Error

  • HTTP Status Code 503: Backend Fetch Failed