Один постамат

GET /v1/terminals/{code}

Постамат со списком ячеек и тем, что в них лежит. Машина опознаётся своим кодом — тем, что указан в договоре и написан на самой машине, а не внутренним идентификатором базы.

Параметры адреса

Параметр	Тип	Описание
code	строка	Код постамата — тот, что указан в договоре и на самой машине

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

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

Ответ

{
  "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": [
    {
      "id": "ckq7f3k9p0001",
      "number": 13,
      "size": "M",
      "door_open": false,
      "occupied": true,
      "locked": false,
      "lock_reason": null,
      "service": false,
      "state_at": "2026-10-10T09:14:20.000Z",
      "product": {
        "id": "cmg4h7j2k0003",
        "name": "Перчатки",
        "sku": "GL-10",
        "quantity": 3
      }
    }
  ]
}

Поля ответа

Поле	Описание
number	Номер на фасаде — единственное имя ячейки в API
size	Размер: S, M или L
occupied	Сработал ли датчик занятости
door_open	Открыта ли дверца прямо сейчас
locked	Заблокирована оператором: временно не выдаётся
service	Служебная ячейка: в выдаче не участвует никогда
product	Что лежит и сколько штук. null — ячейка пуста
state_at	Когда постамат последний раз сообщал состояние этой ячейки

Ошибки

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

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

Заблокированная и служебная — разные вещи

locked — «временно не выдавать»: ячейку чинят или она занята под разбор. service — «никогда не выдавать, но обслуживать»: в ней оборудование машины. Открыть служебную через API нельзя вовсе, это делает наш оператор из админки.