Перейти до вмісту
Santiago Santiago Docs

Імпорт та експорт куків

Куки зберігають стан авторизації для сайтів, які ви відвідуєте у профілі. Santiago дозволяє зберегти куки профілю у JSON-файл та завантажити їх назад пізніше — зручно, щоб перенести сесію між профілями, зробити резервну копію або відновити вхід без повторного введення пароля.

Що ви можете робити

Section titled “Що ви можете робити”
ДіяЩо вона робить
ЕкспортЗавантажує всі поточні куки профілю у файл .json, який ви зберігаєте на своєму комп’ютері.
ІмпортВідкриває вікно вибору файлу та додає куки з JSON-файлу до профілю.

Експорт куків профілю

Section titled “Експорт куків профілю”

Використовуйте експорт, щоб зберегти знімок сесії профілю — наприклад, перед її очищенням або щоб скопіювати вхід в інший профіль.

  1. Запустіть профіль, з якого хочете експортувати.
  2. Оберіть Export cookies у меню профілю.
  3. Santiago завантажує файл .json з усіма куками, що наразі збережені у цьому профілі.

Зберігайте файл у надійному місці. JSON містить токени сесій, тож ставтеся до нього як до пароля.

Імпорт куків із файлу

Section titled “Імпорт куків із файлу”

Імпорт дозволяє завантажити куки з JSON-файлу назад у профіль.

  1. Запустіть профіль, у який хочете імпортувати.
  2. Оберіть Import cookies у меню профілю.
  3. Виберіть свій файл .json у вікні вибору файлу.
  4. Santiago читає файл та додає куки до профілю.

Що насправді робить імпорт

Section titled “Що насправді робить імпорт”
  • Імпорт додає куки — він вставляє кожен кук із файлу у профіль, один за одним.
  • Він не очищає наявні куки профілю перед цим. Нові куки додаються поверх того, що вже є. Якщо кук з такими самими ім’ям, доменом і шляхом уже існує, імпортоване значення замінює його.
  • Файл має бути JSON-масивом куків — тієї самої форми, яку ви отримуєте під час експорту. Експорт з одного профілю та імпорт в інший — найнадійніший спосіб перенести сесію.

Вимоги та обмеження

Section titled “Вимоги та обмеження”
  • Профіль має бути запущений. І експорт, і імпорт діють на живу браузерну сесію, тож запустіть профіль перед використанням будь-якого з них.
  • Для імпорту потрібна активна підписка. Імпорт куків — одна з дій, обмежених вашим тарифом, поряд із запуском та створенням профілів. Якщо ваша підписка завершилася або ви ще не обрали тариф, імпорт недоступний, доки у вас не буде активного тарифу. Дивіться Тарифи та ціни і Стани ліцензії.
  • Експорт працює навіть коли ваша підписка завершилася — ви завжди можете витягнути свої куки назад, тож ніколи не втратите доступ до збережених сесій.

Автоматизуйте це (для агентів та розробників)

Section titled “Автоматизуйте це (для агентів та розробників)”

Усе вищеописане також доступне через локальний API Santiago на http://localhost:7891, тож агенти та скрипти можуть читати й записувати куки профілю без кліків по застосунку. Це той самий API, який використовує навичка для агента.

Ендпоінти для куків живуть у profile API та працюють, доки профіль запущений:

Export, import, and clear cookies
# Export all cookies as JSON
curl -s localhost:7891/api/profiles/$PROFILE/cookies | jq .data


# Import cookies from JSON (adds them, does not clear first)
curl -s localhost:7891/api/profiles/$PROFILE/cookies -X POST \
  -H 'Content-Type: application/json' -d '[{...}, {...}]'


# Clear all cookies
curl -s localhost:7891/api/profiles/$PROFILE/cookies -X DELETE


# Clear by filter (any combo of name / domain / path) — exact match
curl -s "localhost:7891/api/profiles/$PROFILE/cookies?domain=.example.com" -X DELETE

Кожна відповідь використовує стандартну обгортку: { "ok": true, "data": {...} } у разі успіху або { "ok": false, "error": { "code", "message" } } у разі помилки.

Повний набір можливостей автоматизації — навігація, форми, скриншоти та решта — дивіться у гайді з HTTP API та довіднику API.

Пов’язані сторінки

Section titled “Пов’язані сторінки”