Страница наклейки конструкции

GET /v1/structure/{code}

https://verify.tanba-ooh.kz/v1/structure/{code}

Что открывает печатная наклейка (/s/{code} на хосте verify): конструкция, ее оператор и согласования, действующие на ней сейчас; персональных данных нет. С Accept: application/json приходит JSON.

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

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

Параметры

Имя	Где	Тип	Обязательный	Описание	Пример
`code`	путь	string	да	Код конструкции, напечатанный на наклейке.	`ALM-0012`

Ответы

200 Конструкция и действующие на ней согласования.

`application/json`

PublicStructure

Имя	Тип	Обязательный	Описание	Пример
`structure`	object	да	Конструкция, которой принадлежит наклейка.
`structure.code`	string	да	Код конструкции, напечатанный на наклейке.	`"ALM-0012"`
`structure.format`	object	да	Название формата конструкции на каждом языке.
`structure.format.kk`	string	да	Текст на казахском.	`"Ситиборд"`
`structure.format.ru`	string	да	Текст на русском.	`"Ситиборд 3,7x2,7"`
`structure.format.en`	string	да	Текст на английском.	`"City board 3.7x2.7"`
`structure.district`	object	да	Название района на каждом языке.
`structure.district.kk`	string	да	Текст на казахском.	`"Ситиборд"`
`structure.district.ru`	string	да	Текст на русском.	`"Ситиборд 3,7x2,7"`
`structure.district.en`	string	да	Текст на английском.	`"City board 3.7x2.7"`
`structure.operator`	string	да	Название организации-оператора.	`"Alma Outdoor LLP"`
`approvals`	array of object	да	Согласования, действующие на конструкции сейчас.
`approvals[].number`	string	да	Номер согласования.	`"TNB-2026-000123"`
`approvals[].status`	string	да	Состояние согласования. active, expiring
`approvals[].valid_from`	string (date)	да	Первый день действия согласования.	`"2026-10-01"`
`approvals[].valid_until`	string (date)	да	Последний день действия согласования.	`"2026-12-31"`
`approvals[].regulation`	object	да	Регламент, по которому выдано согласование.

Пример

{
  "structure": {
    "code": "ALM-0012",
    "format": {
      "kk": "Ситиборд",
      "ru": "Ситиборд 3,7x2,7",
      "en": "City board 3.7x2.7"
    },
    "district": {
      "kk": "Ситиборд",
      "ru": "Ситиборд 3,7x2,7",
      "en": "City board 3.7x2.7"
    },
    "operator": "Alma Outdoor LLP"
  },
  "approvals": [
    {
      "number": "TNB-2026-000123",
      "status": "active",
      "valid_from": "2026-10-01",
      "valid_until": "2026-12-31",
      "regulation": {}
    }
  ]
}

`text/html`

Ошибки

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

Статус	Значение
404	Неизвестный код конструкции (тот же ответ, что на неизвестный номер согласования).
429	Превышен предел частоты; см. `Retry-After`.

Примеры кода

curl

curl 'https://verify.tanba-ooh.kz/v1/structure/ALM-0012' \
  -H 'Accept: application/json'

Python

import requests

response = requests.get(
    "https://verify.tanba-ooh.kz/v1/structure/ALM-0012",
    headers={
        "Accept": "application/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/structure/ALM-0012", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	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))
}