/v1/browser — это Fetch, у которого есть продолжение. Fetch забирает страницу
и закрывает вкладку; здесь вкладка живёт между вызовами, и следующий запрос
попадает в тот же браузер, с теми же куками и той же историей.
Сделано для агентов и автоматизации: агент не видит пикселей, поэтому вместо
снимка с координатами он получает список того, на что можно нажать, с
устойчивой ссылкой на каждый элемент.
Когда брать Browser, а когда Fetch
Правило простое: если между двумя обращениями к сайту ничего не должно
сохраниться — берите Fetch. Сессия нужна ровно тогда, когда следующий шаг
зависит от предыдущего.
Порядок работы
1
Открыть
POST /v1/browser/open — заводит сессию и возвращает session_id вместе со
списком элементов.2
Посмотреть, что на странице
В каждом ответе приходит
elements: кнопки и поля с ссылкой ref на
каждый.3
Действовать
POST /v1/browser/click или POST /v1/browser/fill — по одному действию за
вызов. В ответ снова приходит состояние страницы.4
Закрыть
POST /v1/browser/close. Бесплатно и необязательно: сессия закроется и
сама, по простою или по потолку.Страницы раздела
Инициализация
Что происходит между вашим первым запросом и открытой вкладкой: слот пула,
профиль, адрес выхода, эмуляция.
open
Открыть страницу и завести сессию. Параметры, ответ, примеры.
Элементы и ссылки
Что такое
ref, почему это не селектор и что заказывать в include.click
Нажать на элемент и получить состояние страницы после нажатия.
fill
Заполнить поле посимвольно и увидеть, что вправду в нём оказалось.
close
Закрыть сессию досрочно и освободить слот.
state
Перечитать страницу в живой сессии: свежий список элементов без действий.
sessions
Сколько сессий открыто сейчас и сколько ещё можно открыть.
Догрузка страницы
Поле
settled: получили вы всё или обрывок, и как это отличить.Сроки жизни и куки
Простой, потолок, сколько сессий разом и что делается с куками.
Ошибки
Коды отказов, какие повторяются сами и что делать с каждым.
Цена
Сколько кредитов стоит шаг и почему считаются шаги, а не время.
Пять ручек и один порядок:
open → смотрим elements → click или fill →
снова смотрим → close. Шестая, sessions, ничего не меняет — только
показывает, что открыто сейчас.