Registered sellers

GET /v1/market/sellers.json

https://verify.tanba-ooh.kz/v1/market/sellers.json

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

The adtech organisations registered with the platform that may be named as sellers of screens, in the field names of the IAB sellers.json format: seller_id (the seller account that appears in source.schain), name, domain and seller_type. Seller accounts of supply-side platforms and trading desks with a domain that operators authorise today are listed, once per account; every entry has the type INTERMEDIARY. Compare the source.schain of a bid request with this list and with authorised_sellers[].seller_account_id of the screen in the inventory. No credentials. Cached for five minutes; send If-None-Match to revalidate.

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

Не требуется. Вызов открытый.

Параметры

Имя	Где	Тип	Обязательный	Описание	Пример
`If-None-Match`	заголовок	string	нет	The `ETag` of a copy you already hold; the answer is then 304 without a body.	`"6f1c0a7d5b2e49c8a3d1e7f0"`

Ответы

200 The list of sellers.

`application/json`

SellersJson

Имя	Тип	Обязательный	Описание	Пример
`version`	string	да	Version of the sellers.json format.	`"1.0"`
`sellers`	array of object	да	Registered sellers, ordered by name.
`sellers[].seller_id`	string	да	The seller account, as in `source.schain`; the value to compare with `seller_account_id` of the screen's authorised sellers.	`"pub-4711"`
`sellers[].name`	string	да	Legal name of the organisation that holds the account.	`"SSP One LLP"`
`sellers[].domain`	string	да	Domain of the organisation.	`"ssp-one.example"`
`sellers[].seller_type`	string	да	The sellers.json type; always `INTERMEDIARY`. INTERMEDIARY

Пример

{
  "version": "1.0",
  "sellers": [
    {
      "seller_id": "pub-4711",
      "name": "SSP One LLP",
      "domain": "ssp-one.example",
      "seller_type": "INTERMEDIARY"
    }
  ]
}

304 The copy you hold is current.

Без тела.

Ошибки

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

Статус	Значение
429	Превышен предел частоты; см. `Retry-After`.

Примеры кода

curl

curl 'https://verify.tanba-ooh.kz/v1/market/sellers.json'

Python

import requests

response = requests.get(
    "https://verify.tanba-ooh.kz/v1/market/sellers.json",
)
print(response.status_code, response.text)

package main

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

func main() {
	req, err := http.NewRequest("GET", "https://verify.tanba-ooh.kz/v1/market/sellers.json", nil)
	if err != nil {
		panic(err)
	}
	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))
}