sessions: что открыто сейчас

Показывает, сколько сессий открыто на сервисе и сколько ещё можно открыть. Ничего не меняет и ничего не стоит.

Запрос

curl "https://api.parreq.com/v1/browser/sessions" \
  -H "Authorization: Bearer pr_ВАШКЛЮЧ"

res = requests.get(
    "https://api.parreq.com/v1/browser/sessions",
    headers={"Authorization": "Bearer pr_ВАШКЛЮЧ"},
    timeout=30,
).json()

print(f"занято {res['live']} из {res['max']}")

const res = await fetch("https://api.parreq.com/v1/browser/sessions", {
  headers: { "Authorization": "Bearer pr_ВАШКЛЮЧ" },
}).then((r) => r.json());

console.log(`занято ${res.live} из ${res.max}`);

Ответ

{
  "sessions": [
    {
      "session_id": "bs_9f2a41c7e8b0",
      "url": "https://example.com/account",
      "steps": 4,
      "profile_id": "pf_31c7",
      "idle_left": 7,
      "life_left": 64
    }
  ],
  "live": 1,
  "max": 4,
  "idle_sec": 60,
  "max_life_sec": 120
}

integer

Сколько сессий открыто прямо сейчас.

integer

Потолок одновременных сессий на весь сервис.

integer

Действующий срок простоя в секундах. Берите его отсюда, а не из документации: значение настраивается, и здесь оно всегда настоящее.

integer

Действующий потолок жизни сессии в секундах.

array

Строка на каждую живую сессию: идентификатор, текущий адрес, число шагов, профиль браузера и остатки по обоим срокам.

Зачем это нужно

Понять причину отказа

sessions_busy в ответ на open — здесь видно, все ли места вправду заняты.

Найти забытую сессию

Сессия, оставшаяся после упавшего кода, видна по session_id — её можно закрыть.

Взять настоящие сроки

idle_sec и max_life_sec — источник правды для вашего кода вместо зашитых чисел.

Присмотр

Периодический опрос показывает, упирается ли ваша нагрузка в потолок.

Счётчик общий для сервиса, а не для вашего ключа: в live попадают и чужие сессии. Планируя нагрузку, исходите из того, что все четыре места вашими не будут.

Начало

Search

Fetch

Browser API

Crawler

Агенты и MCP

Библиотеки

Как это работает

sessions: что открыто сейчас

Запрос

Ответ

Зачем это нужно

Понять причину отказа

Найти забытую сессию

Взять настоящие сроки

Присмотр

​Запрос

​Ответ

​Зачем это нужно

Понять причину отказа

Найти забытую сессию

Взять настоящие сроки

Присмотр

Запрос

Ответ

Зачем это нужно