Structures as CSV
GET /api/v1/exports/structures.csv
https://app.tanba-ooh.kz/api/v1/exports/structures.csv
Технический текст справочника написан на английском.
Scope read:structures.
Аутентификация
Ключ API в заголовке Authorization или сессия консоли.
Право доступа: read:structures
Параметры
| Имя | Где | Тип | Обязательный | Описание | Пример |
|---|---|---|---|---|---|
sep | запрос | string | нет | Column separator; semicolon for spreadsheets set to a comma decimal mark. comma, semicolon | comma |
Ответы
200 CSV в UTF-8 с меткой порядка байтов и строкой заголовков.
text/csv
Пример
string
Ошибки
Ошибки приходят документом problem (application/problem+json) со стабильным полем code.
| Статус | Значение |
|---|---|
| 401 | Нет действительной сессии или ключа API (unauthenticated, session_expired, invalid_api_key). |
| 403 | Роль или право ключа этого не допускает (forbidden, key_scope_denied, key_route_denied). |
| default | Ошибка в виде документа problem. |
Примеры кода
curl
curl 'https://app.tanba-ooh.kz/api/v1/exports/structures.csv' \
-H 'Authorization: Bearer YOUR_API_KEY'
Python
import requests
response = requests.get(
"https://app.tanba-ooh.kz/api/v1/exports/structures.csv",
headers={
"Authorization": "Bearer YOUR_API_KEY",
},
)
print(response.status_code, response.text)
Go
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://app.tanba-ooh.kz/api/v1/exports/structures.csv", 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))
}