Список постаматов

GET /v1/terminals

Все постаматы вашей компании с живым состоянием. С этого метода обычно начинают интеграцию: он показывает, какие машины доступны по вашему ключу и какими кодами они называются дальше во всех остальных методах.

Чужие машины недоступны: выборка идёт по компании, которой выдан ключ. Если список пуст, значит за вашей компанией ещё не закреплено ни одного постамата — это настраивается на нашей стороне.

Пример запроса

curl -X GET 'https://api.tetrabox.ru/v1/terminals' \
  -H 'Authorization: Bearer tbx_live_7f3c9a1e2b8d4c5f6a0e9d8c7b6a5f4e3d2c1b0a'

Ответ

{
  "terminals": [
    {
      "code": "postamat-01",
      "title": "Склад на Примерной",
      "address": "Санкт-Петербург, Примерная улица, 1",
      "city": "Санкт-Петербург",
      "online": true,
      "controller_ok": true,
      "firmware": "0.8.0",
      "last_seen_at": "2026-10-10T09:14:22.000Z",
      "facade": {
        "cabinets": 4,
        "rows": 6
      },
      "cells_total": 24
    }
  ]
}

Поля ответа

Поле	Описание
code	Код машины. Им она называется во всех остальных методах
online	Выходила ли на связь в последние три минуты
controller_ok	Отвечает ли плата управления замками
last_seen_at	Когда постамат последний раз присылал состояние, UTC
facade	Сколько шкафов стоит в ряд и сколько ячеек в шкафу по вертикали — чтобы нарисовать постамат картинкой, а не списком номеров
cells_total	Сколько ячеек заведено на машине

Ошибки

Код	Машинный код	Когда
401	unauthorized	ключ не передан, отозван либо неверен

Формат тела отказа одинаков у всех методов — Коды ошибок.

Нумерация ячеек

Номер ячейки выводится из facade однозначно: нумерация идёт сверху вниз, шкафы слева направо, то есть номер = (шкаф − 1) × rows + ряд.