Перейти до вмісту
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

Відкриває стек інструмента в новій вкладці або новому вікні. Вкладка отримує назву за символом інструмента. Сторона й частка графіка беруться з налаштувань мультив’ю, але якщо там вибрано «Без графіків», графік усе одно відкривається зверху.