Prefetch API

The serverside.ai pre-fetch API offers a robust solution for the efficient delivery of ad sources, ensuring they are conditioned and ready for use upon request.

Get the ad medias for a given channel

GET https://admin.serverside.ai/api/v2/medias

Headers

Name	Type	Description
x-api-key*	String	Your serverside.ai API key

Request Body

Name	Type	Description
type	String	deliverable for ready conditioned medias source for ad media source
channelId	String	Request for a given channel

Prefetch ad media condition for given channel

PUT https://admin.serverside.ai/api/v2/channel-assets

Headers

Name	Type	Description
x-api-key*	String	Your serverside.ai API key

Request Body

Name	Type	Description
id*	String	Unique Identifier of the ad creative
name*	String	Name of the ad creative/campaign
source*	String	URL to the ad media creative
channelId*	String	Provide the channel Id for which the prefetch should be applied
allChannels	boolean	true if should be applied to all configured channels.

200: OK Successful

400: Bad Request

{
  "name": "BadRequestError",
  "message": "BadRequest",
  "code": 400,
  "type": "Your input data is not valid."
}

401: Unauthorized

{
  "name": "UnAuthorizedError",
  "message": "Unauthorized",
  "code": 401,
  "type": "Request cannot be authenticated. Check if you are transferring an API-Key or JWT in the header."
}

403: Forbidden

{
  "name": "ForbiddenError",
  "message": "Forbidden",
  "code": 403,
  "type": "You have no rights to access the resorce."
}

404: Not Found

{
  "name": "NotFoundError",
  "message": "NotFound",
  "code": 404,
  "type": "No such item."
}

500: Internal Server Error

{
  "name": "ServerError",
  "message": "ServerError",
  "code": 500,
  "type": "Error on server side."
}