Суперпулы

  • API
  • Суперпулы

Суперпулы

Доступ к суперпулам предоставляется всем пользователям,у которых указано соответствующее разрешение в личном кабинете.
Для получения информации о суперпулах предусмотрены следующие запросы:

Метод list позволяет получить список суперпулов

Запрос:

{site_path}/{lang}/api/super-pool/list

Список GET параметров:

filter array Позволяет фильтровать данные по всем доступным полям
fields string Позволяет выбрать из всех доступных только указанные поля
sort string Позволяет сортировать по возрастанию и по убыванию сущности по всем доступным полям
page int Позволяет передать порядковый номер страницы списка сущностей

Список всех доступных полей

id int ID суперпула
name string Название суперпула
format int Размер суперпула
type int ID типа суперпула
assignID int ID ответсовенного суперпула
created_by int ID создателя суперпула
updated_by int ID последнего редактировавшего суперпул
created_at int Время создания суперпула в формате UTC
updated_at int Время последнего редактирования в формате UTC
typeName string Тип суперпула
clicks int Общее количество кликов
clicksToday int Количество кликов за текущие сутки
clicksYtd int Количество кликов за прошедшие сутки
views int Общее количество просмотров
viewsToday int Количество просмотров за текущие сутки
viewsYtd int Количество просмотров за прошедшие сутки
active boolean Статус суперпула
Значения:
  • 1 - активен
  • 0 - не активен
tag array Теги

Ответ

Ответ передается в формате JSON. Список полей ответа:

result array Список суперпулов с учетом параметров запроса
_links array Список ссылок навигации. Может содержать элементы:
  • self - содержит ссылку на текущую страницу списка
  • first - содержит ссылку на первую страницу списка
  • last - содержит ссылку на последнюю страницу списка
  • prev - содержит ссылку на предыдущую страницу списка
  • next - содержит ссылку на следующую страницу списка
_meta array Информация по навигации списка. Содержит элементы:
  • totalCount - общееколичество доступных сущностей учитывая все выбранные параметры
  • pageCount - порядковый номер сущности в полученном списке, с которого начинается текущая страница
  • currentPage - порядковый номер текущей страницы
  • perPage - количество сущностей отображаемых на одной странице

Пример запроса:

{site_path}/{lang}/api/super-pool/list?filter[id][in][]=1225878269&filter[id][in][]=1228963959&sort=name

Пример ответа:

{
  "result": [
    {
      "id": 1225878269,
      "name": "another superpool name",
      "format": 0,
      "typeID": 1,
      "assignID": 0,
      "created_by": 1214768575,
      "created_at": 1530824611,
      "updated_by": 1214768575,
      "updated_at": 1530824611,
      "typeName": "branding",
      "views": "237846518",
      "viewsToday": "0",
      "viewsYtd": "0",
      "clicks": "1038323",
      "clicksToday": "4",
      "clicksYtd": "5",
      "active": "1",
      "tag": {
        "1": "sport",
        "2": "general"
      }
    },
    {
      "id": 1228963959,
      "name": "superpool name",
      "format": 0,
      "typeID": 6,
      "assignID": 0,
      "created_by": 1839588080,
      "created_at": 1568892857,
      "updated_by": 1839588080,
      "updated_at": 1570797146,
      "typeName": "VAST",
      "views": "28781804",
      "viewsToday": "82451",
      "viewsYtd": "219562",
      "clicks": "1704737",
      "clicksToday": "5026",
      "clicksYtd": "13378",
      "active": "1",
      "tag": {
        "2": "general"
      }
    }
  ],
  "_links": {
    "self": {
      "href": "{site_path}/{lang}/api/super-pool/list?filter%5Bid%5D%5Bin%5D%5B0%5D=1228963959&filter%5Bid%5D%5Bin%5D%5B1%5D=1225878269&sort=name&page=1"
    }
  },
  "_meta": {
    "totalCount": 2,
    "pageCount": 1,
    "currentPage": 1,
    "perPage": 20
  }
}

Метод view позволяет получить расширенную информацию по суперпулам

Запрос:

{site_path}/{lang}/api/super-pool/view/[id]

Список GET параметров:

id int Является обязательным параметром. Порядковый номер суперпула
fields string Позволяет выбрать из всех доступных только указанные поля
*Не распространяется на поля связанных сущностей

Список всех доступных полей

id int ID суперпула
name string Название суперпула
format int Размер суперпула
type int ID типа суперпула
assignID int ID ответсовенного суперпула
created_by int ID создателя суперпула
updated_by int ID последнего редактировавшего суперпул
created_at int Время создания суперпула в формате UTC
updated_at int Время последнего редактирования в формате UTC
typeName string Тип суперпула
clicks int Общее количество кликов
clicksToday int Количество кликов за текущие сутки
clicksYtd int Количество кликов за прошедшие сутки
views int Общее количество просмотров
viewsToday int Количество просмотров за текущие сутки
viewsYtd int Количество просмотров за прошедшие сутки
active boolean Статус суперпула
Значения:
  • 1 - активен
  • 0 - не активен
auction array Торги
Может содержать:
pool array Связанные с суперпулом пулы
Может содержать:
tag array Теги

Пример запроса:

{site_path}/{lang}/api/super-pool/view/1297235890

Пример ответа:

{
  "id": 1297235890,
  "name": "superpool name",
  "format": 0,
  "typeID": 10,
  "assignID": 0,
  "created_by": 1839588080,
  "created_at": 1574934147,
  "updated_by": 1839588080,
  "updated_at": 1574934147,
  "typeName": "VAST",
  "views": "28781804",
  "viewsToday": "82451",
  "viewsYtd": "219562",
  "clicks": "1704737",
  "clicksToday": "5026",
  "clicksYtd": "13378",
  "active": 1,
  "auction": [
    {
      "type": "segment",
      "id": "1940156536",
      "name": "segment name",
      "userID": "1443076549",
      "assignID": "0",
      "chain": "0",
      "priority": "1",
      "views": "48280",
      "viewsToday": "395",
      "viewsYtd": "715",
      "clicks": "295",
      "clicksToday": "3",
      "clicksYtd": "5",
      "attach_created_by": "1839588080",
      "attach_updated_by": "1839588080",
      "attach_created_at": "1574935590",
      "attach_updated_at": "1574935590",
      "attached": "1",
      "active": "1"
    },
    {
      "type": "segment",
      "id": "2005158834",
      "name": "another name",
      "userID": "1968035714",
      "assignID": "0",
      "chain": "0",
      "priority": "1",
      "views": "1515932",
      "viewsToday": "11963",
      "viewsYtd": "24569",
      "clicks": "13600",
      "clicksToday": "91",
      "clicksYtd": "184",
      "attach_created_by": "1839588080",
      "attach_updated_by": "1839588080",
      "attach_created_at": "1574939665",
      "attach_updated_at": "1574939665",
      "attached": "1",
      "active": "1"
    }
  ],
  "pool": [
    {
      "type": "pool",
      "id": "1773271312",
      "name": "pool name",
      "active": "1",
      "attached": "1",
      "chain": "0",
      "priority": "1",
      "views": "0",
      "viewsToday": "0",
      "viewsYtd": "0",
      "clicks": "0",
      "clicksToday": "0",
      "clicksYtd": "0",
      "created_by": "1839588080",
      "updated_by": "1839588080",
      "created_at": "1574934116",
      "updated_at": "1574934116",
      "attach_created_by": "1839588080",
      "attach_updated_by": "1839588080",
      "attach_created_at": "1574934147",
      "attach_updated_at": "1574934147"
    },
    {
      "type": "segment",
      "id": "1940156536",
      "name": "another name",
      "active": "1",
      "attached": "0",
      "chain": "0",
      "priority": "1",
      "views": "159",
      "viewsToday": "0",
      "viewsYtd": "0",
      "clicks": "0",
      "clicksToday": "0",
      "clicksYtd": "0",
      "created_by": "1839588080",
      "updated_by": "1839588080",
      "created_at": "1574935590",
      "updated_at": "1574935590",
      "attach_created_by": "0",
      "attach_updated_by": "0",
      "attach_created_at": "0",
      "attach_updated_at": "0"
    },
  ],
  "tag": [
    {"id": 1, "name": "sport"},
    {"id": 2, "name": "general"},
  ]
}