The audience multiplier of a quarter hour of a screen

GET /api/v1/market/multipliers

https://app.tanba-ooh.kz/api/v1/market/multipliers

Технический текст справочника написан на английском.

Scope read:inventory. Served only once the platform has switched the audience service on (it is off by default); until then 404. The multiplier is impacts divided by spots for the structure, the month, the ISO weekday and the quarter hour of at read in Almaty time, from the newest released release of an approved audience source. When the source has no row for that quarter hour the answer has no qty at all: there is no default value, and the placeholder audience estimate is never used. qty is the OpenRTB 2.6 object for imp.qty, with sourcetype 1 (measurement vendor) and vendor tanba-ooh.kz. Free for registered participants and the same for every one of them; a release is served to all from its release day.

Аутентификация

Ключ API в заголовке Authorization или сессия консоли.

Право доступа: read:inventory

Параметры

Имя	Где	Тип	Обязательный	Описание	Пример
`structure`	запрос	string	да	Structure code.	`ALM-0001`
`at`	запрос	string (date-time)	да	The instant of the impression (RFC 3339).	`2027-03-10T10:07:00+05:00`

Ответы

200 The slot, with `qty` when the source has a row for it.

`application/json`

MultiplierAnswer

Имя	Тип	Обязательный	Описание	Пример
`structure`	string	да	Structure code.	`"ALM-0001"`
`at`	string (date-time)	да	The instant asked about, Almaty time.	`"2027-03-10T10:07:00+05:00"`
`slot`	object	да	The table cell the instant falls in.
`slot.month`	string	да	Month in Almaty time.	`"2027-03"`
`slot.weekday`	integer	да	ISO weekday, 1 Monday.	`3`
`slot.quarter`	integer	да	Quarter hour of the day, 0 is 00:00-00:15.	`40`
`qty`	object		OpenRTB 2.6 `imp.qty`; absent when no approved source has a row for the slot.
`qty.multiplier`	number	да	Impressions per spot in this quarter hour.	`6.003`
`qty.sourcetype`	integer	да	Measurement vendor. 1
`qty.vendor`	string	да	Vendor domain. tanba-ooh.kz
`source`	object		Who measured it; present with `qty`.
`source.vendor`	string	да	Name of the audience source.	`"Example Mobility Ltd"`
`source.release`	string	да	Label of the release.	`"2027-A"`

Пример

{
  "structure": "ALM-0001",
  "at": "2027-03-10T10:07:00+05:00",
  "slot": {
    "month": "2027-03",
    "weekday": 3,
    "quarter": 40
  },
  "qty": {
    "multiplier": 6.003,
    "sourcetype": 1,
    "vendor": "tanba-ooh.kz"
  },
  "source": {
    "vendor": "Example Mobility Ltd",
    "release": "2027-A"
  }
}

Ошибки

Ошибки приходят документом problem (application/problem+json) со стабильным полем code.

Статус	Значение
401	Нет действительной сессии или ключа API (`unauthenticated`, `session_expired`, `invalid_api_key`).
403	Роль или право ключа этого не допускает (`forbidden`, `key_scope_denied`, `key_route_denied`).
404	Ничего нет или вызывающему это не видно.
422	Ошибки полей (`validation_failed`).
default	Ошибка в виде документа problem.

Примеры кода

curl

curl 'https://app.tanba-ooh.kz/api/v1/market/multipliers?structure=ALM-0001&at=2027-03-10T10%3A07%3A00%2B05%3A00' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Python

import requests

response = requests.get(
    "https://app.tanba-ooh.kz/api/v1/market/multipliers?structure=ALM-0001&at=2027-03-10T10%3A07%3A00%2B05%3A00",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
    },
)
print(response.status_code, response.text)

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://app.tanba-ooh.kz/api/v1/market/multipliers?structure=ALM-0001&at=2027-03-10T10%3A07%3A00%2B05%3A00", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	data, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.Status, string(data))
}