Перейти к содержимому
Spectre Docs
РуководствоРазработчикам
HTTP APIРабочее пространство

Открыть вкладку с инструментами

Собрать запрос

Меняйте значения — команда меняется следом. Токен здесь не вводится: команда берёт его из переменной окружения SPECTRE_LOCAL_API_TOKEN. Запускайте её в своей командной строке.

Команда
curl -X POST 'http://127.0.0.1:48180/v1/workspace/tabs' \
  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "items": [
    {
      "instrument": "binance:futures:BTCUSDT",
      "chart": true
    },
    {
      "instrument": "bybit:futures:ETHUSDT",
      "connection_id": 31
    }
  ],
  "name": "Majors",
  "target": "new_tab",
  "window_id": 1,
  "activate": true
}'
POST
/workspace/tabs

Открывает вкладку с колонкой на каждый элемент items, в порядке списка. Без name вкладка получает символ первого инструмента и число остальных, если они есть: BTCUSDT +1. Сторона и доля графика берутся из настроек мультивью.

Авторизация

bearerToken workspace:write
headerАвторизацияBearer <token>

Токен Local API: spt_ и 64 шестнадцатеричных символа. Скопируйте его в Settings App → Общие → Local API. Он принимается только в заголовке Authorization. Имена, перечисленные у операции, — это права, которые ей нужны. У токена терминала есть все.

Право: workspace:write

Тело запроса

application/json
  1. body
items*array<>
Элементы1 <= items <= 50
name?string
Длинаlength <= 64
target?WorkspaceTarget

new_tab открывает вкладку в окне window_id, а без него — в окне в фокусе. new_window открывает новое окно.

По умолчанию"new_tab"
Значение из"new_tab""new_window"
window_id?integer
Форматint64
Диапазон0 <= value
activate?boolean
По умолчаниюtrue

Тело ответа

Где открылась вкладка. stacks и charts — виджеты новой вкладки, в порядке колонок.

application/json
  1. response

Что открыла или затронула команда рабочего пространства. Номера, которых она касается, заполнены. Остальное — null или пусто.

window_id*|
Форматint64
tab_id*|
Форматint64
stacks*array<>
charts*array<>
Пример запроса
curl -X POST 'http://127.0.0.1:48180/v1/workspace/tabs' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN" \  -H 'Content-Type: application/json' \  -d '{  "items": [    {      "instrument": "binance:futures:BTCUSDT",      "chart": true    },    {      "instrument": "bybit:futures:ETHUSDT",      "connection_id": 31    }  ],  "name": "Majors",  "target": "new_tab",  "window_id": 1,  "activate": true}'
Пример ответа
{  "window_id": 1,  "tab_id": 2,  "stacks": [    14,    16  ],  "charts": [    15  ]}

Добавить колонки во вкладку POST

Добавляет колонки после последней колонки вкладки. Вкладка сохраняет своё имя и ширины своих колонок. Невыбранная вкладка становится активной на время команды. `stacks` и `charts` в ответе — только добавленные виджеты, в порядке колонок.

Открыть стек POST

Открывает стек инструмента в новой вкладке или в новом окне. Вкладка называется по символу инструмента. Сторона и доля графика берутся из настроек мультивью, но если там выбрано «Без графиков», график всё равно открывается сверху.