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

Сменить инструмент стека

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

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

Команда
curl -X PATCH 'http://127.0.0.1:48180/v1/workspace/stacks/12' \
  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "instrument": "binance:futures:ETHUSDT"
}'
PATCH
/workspace/stacks/{widget_id}

Меняет инструмент стека и графиков его группы. Неактивная вкладка становится активной на время команды.

Авторизация

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

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

Право: workspace:write

Параметры пути

widget_id*integer

widget_id стека из GET /workspace. График отклоняется с invalid_request.

Форматint64
Диапазон0 <= value

Тело запроса

application/json
  1. body
instrument*string

Инструмент из справочника.

connection_id?integer
Форматint64

Тело ответа

Что затронула команда.

application/json
  1. response

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

window_id*|
Форматint64
tab_id*|
Форматint64
stacks*array<>
charts*array<>
Пример запроса
curl -X PATCH 'http://127.0.0.1:48180/v1/workspace/stacks/12' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN" \  -H 'Content-Type: application/json' \  -d '{  "instrument": "binance:futures:ETHUSDT"}'
Пример ответа
{  "window_id": 1,  "tab_id": 1,  "stacks": [    12  ],  "charts": []}

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

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

Закрыть стек DELETE

Работает как кнопка закрытия стека.