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	Rate limit; see `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))
}