Saltar al contenido principal
POST
Create Slot

Autorizaciones

Authorization
string
header
requerido

A valid API key generated in Topsort's UI. Use the TSE API key if calling auctions or events API, otherwise use the TSC API key.

Cuerpo

application/json

Category or search slot create request.

slotId
string
requerido

The unique external slot ID that represents the slot.

Minimum string length: 1
Pattern: ^[\w!\"#$%&'()*+,\-._/:;<>?@\[\]^\{\}~=\\]*$
Ejemplo:

"sidebar-2"

dimensions
SlotCreateRequestDimensions · object
requerido

The dimensions of the slot per device type.

position
enum<string>
requerido
Opciones disponibles:
category,
search

Respuesta

Successful Response

The ad config slot model.

id
string<uuid>
requerido

The ID of the ad config slot.

externalId
string
requerido

The external ID provided by marketplaces.

Minimum string length: 1
position
enum<string>
requerido

The position of the ad config slot.

Opciones disponibles:
landing,
category_search,
category,
search
marketplaceId
string<uuid>
requerido

The ID of the marketplace that the ad config slot belongs to.

dimensions
Dimensions · object
requerido

The slot dimensions. There can be at most one dimension for each device type.

Ejemplo:
page
AdConfigPage · object | null

The page that the ad config slot belongs to. Only 'landing' slots can belong to a page.

isActive
boolean
predeterminado:true

Indicates whether the ad config slot is active. If false, the slot cannot be used in campaigns.