Запуск и остановка браузера

Команды для работы с браузером

start_browser

Команда запуска браузера

Запрос

Пример

{
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "start_browser",
    "echo_mode": 1,
    "conf": [
      {
        "bk_id": "FON",
        "account": "login:password",
        "proxy": {
          "address": "212.192.56.86",
          "port": 49149,
          "protocol": "HTTPS"
        }
      }
    ]
  }
}

Описание

Ключ	Значение	Тип	Обяз-но
session_id	Идентификатор сессии	string
body	Тело запроса	object
⊢ cmd	Имя команды	string
⊢ echo_mode	1 - режим вывода всех логов 0 - выводить только результат	number
⊢ conf	Массив настроек авторизации	array
| ⊢ bk_id	Идентификатор БК	string
| ⊢ account	login:password доступа к аккаунту БК	string
| ⊢ proxy	Настройки прокси сервера	object
| | ⊢ address	IP адрес прокси	string
| | ⊢ port	Порт прокси	number
| | ⊢ protocol	HTTPS или SOCKS5 протокол	string
| | ⊢ user	Имя пользователя	string
| | ∟ pass	Пароль	string

Успех

Пример

{
  "status": [
    2000,
    "SUCCESS",
    "CMD_COMPLETED_SUCCESSFULLY"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "start_browser",
    "result_data": {
      "elapsed_time": 35,
      "bot_status": [
        3,
        "STARTED"
      ],
      "FON": {
        "auth": 1
      }
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	string
⊢ result_data	Результат	object
| ⊢ elapsed_time	Время затраченное на запуск в секундах	number
| ⊢ bot_status	Статус бота	array
| ⊢ <BK_ID>	Идентификатор БК	object
| | ∟ auth	Статус авторизации	number

Информационные ответы

Проверка прокси

Пример

{
  "status": [
    1030,
    "INFO",
    "PROXY_CHECKING"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "start_browser",
    "result_data": {
      "elapsed_time": 1.2,
      "FON": []
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	string
⊢ result_data	Результаты	object
| ⊢ elapsed_time	Время затраченное на запуск в секундах	number
| ∟ <BK_ID>	Идентификатор БК	array

Прокси проверен

Пример

{
  "status": [
    1030,
    "INFO",
    "PROXY_CHECKED"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "start_browser",
    "result_data": {
      "elapsed_time": 3.5,
      "FON": {
        "proxy_check": 1
      }
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	string
⊢ result_data	Результаты	object
| ⊢ elapsed_time	Время с момента запуска команды	number
| ⊢ <BK_ID>	Идентификатор БК	object
| | ∟ proxy_check	Результат проверки прокси сервера	number

Подключение прокси

Пример

{
  "status": [
    1030,
    "INFO",
    "STARTING_PROXIFIER"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "start_browser",
    "result_data": {
      "elapsed_time": 3.5,
      "bot_status": [
        2,
        "STARTING"
      ],
      "FON": {
        "proxy_check": 1
      }
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	string
⊢ result_data	Результаты	object
| ⊢ elapsed_time	Время с момента запуска команды	number
| ⊢ bot_status	Статус бота	array
| ⊢ <BK_ID>	Идентификатор БК	object
| | ∟ proxy_check	Результат проверки прокси сервера	number

Прокси подключен

Пример

{
  "status": [
    1030,
    "INFO",
    "STARTED_PROXIFIER"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "start_browser",
    "result_data": {
      "elapsed_time": 4.5,
      "bot_status": [
        2,
        "STARTING"
      ],
      "FON": {
        "proxy_check": 1
      }
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	string
⊢ result_data	Результаты	object
| ⊢ elapsed_time	Время с момента запуска команды	number
| ⊢ bot_status	Статус бота	array
| ⊢ <BK_ID>	Идентификатор БК	object
| | ∟ proxy_check	Результат проверки прокси сервера	number

Браузер запускается

Пример

{
  "status": [
    1030,
    "INFO",
    "STARTING_BROWSER"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "start_browser",
    "result_data": {
      "elapsed_time": 15,
      "bot_status": [
        2,
        "STARTING"
      ],
      "FON": {
        "proxy_check": 1
      }
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	string
⊢ result_data	Результаты	object
| ⊢ elapsed_time	Время с момента запуска команды	number
| ⊢ bot_status	Статус бота	array
| ⊢ <BK_ID>	Идентификатор БК	object
| | ∟ proxy_check	Результат проверки прокси сервера	number

Браузер запущен

Пример

{
  "status": [
    1030,
    "INFO",
    "STARTED_BROWSER"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "start_browser",
    "result_data": {
      "elapsed_time": 35,
      "bot_status": [
        3,
        "STARTED"
      ],
      "FON": {
        "proxy_check": 1
      }
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	string
⊢ result_data	Результаты	object
| ⊢ elapsed_time	Время с момента запуска команды	number
| ⊢ bot_status	Статус бота	array
| ⊢ <BK_ID>	Идентификатор БК	object
| | ∟ proxy_check	Результат проверки прокси сервера	number

Вход в аккаунт БК

Пример

{
  "status": [
    1030,
    "INFO",
    "LOGGING_IN"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "start_browser",
    "result_data": {
      "elapsed_time": 35,
      "bot_status": [
        3,
        "STARTED"
      ],
      "FON": {
        "auth": 0,
        "proxy_check": 1
      }
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	string
⊢ result_data	Результаты	object
| ⊢ elapsed_time	Время с момента запуска команды	number
| ⊢ bot_status	Статус бота	array
| ⊢ <BK_ID>	Идентификатор БК	object
| | ⊢ auth	Статус авторизации	number
| | ∟ proxy_check	Статус проверки прокси сервера	number

Возможные ошибки

Ошибка прокси

Пример

{
  "status": [
    5030,
    "ERROR",
    "Proxy not working"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": {
      "echo_mode": 1,
      "cmd": "start_browser",
      "conf": [
        {
          "bk_id": "FON",
          "account": "login:password",
          "proxy": {
            "protocol": "HTTPS",
            "port": 49149,
            "address": "212.192.56.86"
          }
        }
      ]
    },
    "result_data": {
      "elapsed_time": 0,
      "FON": {
        "proxy_check": 1
      }
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	object
⊢ result_data	Результаты	object
| ⊢ elapsed_time	Время затраченное на запуск в секундах	number
| ⊢ <BK_ID>	Идентификатор БК	object
| | ∟ proxy_check	Результат проверки прокси сервера	number

Ошибка протокола прокси

Пример

{
  "status": [
    4007,
    "ERROR",
    "BAD_REQUEST: Invalid field value : protocol > HTTPS||SOCKS5"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "result_data": [],
    "cmd": {
      "echo_mode": 1,
      "cmd": "start_browser",
      "conf": [
        {
          "bk_id": "FON",
          "account": "login:password",
          "proxy": {
            "address": "212.192.56.86",
            "port": 49149,
            "protocol": "HTTP"
          }
        }
      ]
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
result_data	Результат	array
cmd	Входная команда	object

Команда уже запущена

Пример

{
  "status": [
    6950,
    "ERROR",
    "STATE_ERROR: Command is currently already running"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "result_data": [],
    "cmd": {
      "cmd": "start_browser"
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ result_data	Результат	array
∟ cmd	Входная команда	object

Браузер останавливается

Пример

{
  "status": [
    6910,
    "ERROR",
    "STATE_ERROR: Browser is not STOPPED  (browser_status=STOPPING[1])"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "result_data": [],
    "cmd": {
      "echo_mode": 1,
      "cmd": "start_browser",
      "conf": [
        {
          "bk_id": "FON",
          "account": "login:password",
          "proxy": {
            "address": "212.192.56.86",
            "port": 49149,
            "protocol": "HTTPS"
          }
        }
      ]
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ result_data	Результат	array
∟ cmd	Входная команда	object

Браузер уже запущен

Пример

{
  "status": [
    6910,
    "ERROR",
    "STATE_ERROR: Browser is not STOPPED  (browser_status=STARTED[3])"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "result_data": [],
    "cmd": {
      "echo_mode": 1,
      "cmd": "start_browser",
      "conf": [
        {
          "bk_id": "FON",
          "account": "login:password",
          "proxy": {
            "address": "212.192.56.86",
            "port": 49149,
            "protocol": "HTTPS"
          }
        }
      ]
    }
  }
}

Описание

Ключ	Значение	Тип
status	Стату ответа	array
session_id	Идентификатор сессии	string
⊢ body	Тело ответа	object
⊢ result_data	Результат	array
∟ cmd	Входная команда	object

Таймаут запуска

Пример

{
  "status": [
    5040,
    "ERROR",
    "Timeout start browser"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": {
      "cmd": "start_browser"
    },
    "result_data": {
      "elapsed_time": 0,
      "bot_status": [
        2,
        "STARTING"
      ]
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ result_data	Результат	object
⊢ cmd	Входная команда	object
| ⊢ elapsed_time	Время затраченное на запуск в секундах	number
| ∟ bot_status	Статус бота	array

Ошибка авторизации

Пример

{
  "status": [
    6035,
    "ERROR",
    "AUTH: Invalid login data"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "isSignedIn",
    "result_data": []
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	string
∟ result_data	Результаты	array

Ошибка БК

Пример

{
  "status": [
    5050,
    "ERROR",
    "Not supported bk_id: BK"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "result_data": [],
    "cmd": {
      "echo_mode": 1,
      "cmd": "start_browser",
      "conf": [
        {
          "bk_id": "BK",
          "account": "login:password",
          "proxy": {
            "protocol": "HTTPS",
            "port": 49149,
            "address": "212.192.56.86"
          }
        }
      ]
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ result_data	Результаты	array
∟ cmd	Входная команда	object

Ошибка ВМ

Пример

{
  "status": [
    5200,
    "ERROR",
    "UNKNOWN_ERROR: unknown response from remote pywmi"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "request_status": -2,
    "status_code": -5004,
    "status_txt": "Unknown error",
    "result_data": {
      "exception_type": "<type 'exceptions.IndexError'>",
      "exception_txt": "list index out of range"
    },
    "cmd": {
      "echo_mode": 1,
      "cmd": "start_browser",
      "conf": []
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	тело ответа	object
⊢ request_status	Статус запроса	number
⊢ status_code	Код статуса	number
⊢ status_txt	Текст статуса	string
⊢ result_data	Результат	array
∟ cmd	Входная команда	object

Коды ошибок валидации

Типы полей

Код	Значение	Описание
4006	BAD_REQUEST: Field type error : echo_mode not int	Поле echo_mode не является числом
4006	BAD_REQUEST: Field type error : bk_id not string	Поле bk_id не является строкой
4006	BAD_REQUEST: Field type error : account not string	Поле account не является строкой
4006	BAD_REQUEST: Field type error : port not int	Поле port не является числом
4006	BAD_REQUEST: Field type error : proxy not dict	Ошибка структуры поля proxy
4006	BAD_REQUEST: Field type error : account not string	Поле account не является строкой
4006	BAD_REQUEST: Field type error : conf not list	Поле conf не является массивом

Обязательные поля

Код	Значение	Описание
4003	BAD_REQUEST: Field is required protocol	Отсутствует поле protocol
4003	BAD_REQUEST: Field is required port	Отсутствует поле port
4003	BAD_REQUEST: Field is required address	Отсутствует поле address
4003	BAD_REQUEST: Field is required proxy	Отсутствует поле proxy
4003	BAD_REQUEST: Field is required account	Отсутствует поле account
4003	BAD_REQUEST: Field is required conf	Отсутствует поле conf

stop_browser

Остановка браузера

Запрос

Пример

{
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "stop_browser"
  }
}

Описание

Ключ	Значение	Тип	Обяз-но
session_id	Идентификатор сессии	string
body	Тело запроса	object
∟ cmd	Имя команды	string

Успех

Пример

{
  "status": [
    2000,
    "SUCCESS",
    "CMD_COMPLETED_SUCCESSFULLY"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "stop_browser",
    "result_data": {
      "elapsed_time": 11.5,
      "bot_status": [
        0,
        "STOPPED"
      ]
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело запроса	object
⊢ cmd	Входная команда	string
⊢ result_data	Результат	object
| ⊢ elapsed_time	Время затраченное на остановку в секундах	number
| ∟ bot_status	Статус бота	фккфн

Информационные ответы

Браузер останавливается

Пример

{
  "status": [
    1030,
    "INFO",
    "STOPPING_BROWSER"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "stop_browser",
    "result_data": {
      "elapsed_time": 5
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	string
⊢ result_data	Результат	object
| ∟ elapsed_time	Время затраченное на остановку в секундах	number

Возможные ошибки

Команда уже запущена

Пример

{
  "status": [
    6950,
    "ERROR",
    "STATE_ERROR: Command is currently already running"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "result_data": [],
    "cmd": {
      "cmd": "stop_browser"
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ result_data	Результат	array
∟ cmd	Входная команда	object

Браузер запускается

Пример

{
  "status": [
    6920,
    "ERROR",
    "STATE_ERROR: Browser is not STARTED  (browser_status=STARTING[2]))"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "result_data": [],
    "cmd": {
      "cmd": "stop_browser"
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ result_data	Результат	array
∟ cmd	Входная команда	object

Браузер уже остановлен

Пример

{
  "status": [
    6920,
    "ERROR",
    "STATE_ERROR: Browser is not STARTED  (browser_status=STOPPED[0]))"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "result_data": [],
    "cmd": {
      "cmd": "stop_browser"
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
⊢ body	тело ответа	object
⊢ result_data	Результат	array
∟ cmd	Входная команда	object

Таймаут остановки

Пример

{
  "status": [
    5040,
    "ERROR",
    "Timeout stop browser"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": {
      "cmd": "stop_browser"
    },
    "result_data": {
      "elapsed_time": 0,
      "bot_status": [
        1,
        "STOPPING"
      ]
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	object
⊢ result_data	Результат	object
| ⊢ elapsed_time	Время затраченное на остановку в секундах	number
| ∟ bot_status	Статус бота	array

browser_status

Проверка текущего статуса браузера

Запрос

Описание

{
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "browser_status"
  }
}

Описание

Ключ	Значение	Тип	Обяз-но
session_id	Идентификатор сессии	string
body	Тело запроса	object
∟ cmd	Имя команды	string

Остановлен

Пример

{
  "status": [
    2000,
    "SUCCESS",
    "CMD_COMPLETED_SUCCESSFULLY"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "browser_status",
    "result_data": {
      "bot_status": [
        0,
        "STOPPED"
      ]
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	object
⊢ result_data	Результат	object
| | ∟ bot_status	Статус бота	array

Останавливается

Пример

{
  "status": [
    2000,
    "SUCCESS",
    "CMD_COMPLETED_SUCCESSFULLY"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "browser_status",
    "result_data": {
      "bot_status": [
        1,
        "STOPPING"
      ]
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	object
⊢ result_data	Результат	object
| | ∟ bot_status	Статус бота	array

Запускается

Пример

{
  "status": [
    2000,
    "SUCCESS",
    "CMD_COMPLETED_SUCCESSFULLY"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "browser_status",
    "result_data": {
      "bot_status": [
        2,
        "STARTING"
      ]
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	object
⊢ result_data	Результат	object
| | ∟ bot_status	Статус бота	array

Запущен

Пример

{
  "status": [
    2000,
    "SUCCESS",
    "CMD_COMPLETED_SUCCESSFULLY"
  ],
  "session_id": "00000000000000000000000000000000",
  "body": {
    "cmd": "browser_status"
    "result_data": {
      "bot_status": [
        3,
        "STARTED"
      ],
      "started_bk": [
        {
          "bk_id": "BT3",
          "login": "viollau",
          "restrict_status": true
        }
      ]
    }
  }
}

Описание

Ключ	Значение	Тип
status	Статус ответа	array
session_id	Идентификатор сессии	string
body	Тело ответа	object
⊢ cmd	Входная команда	string
⊢ result_data	Результат	object
| | ⊢ bot_status	Статус бота	array
| | ⊢ started_bk	Запущенные БК	array
| | | ⊢ bk_id	БК ID	string
| | | ⊢ login	Логин	string
| | | ∟ restrict_status	Возможность делать ставки	boolean

Возможные статусы бота bot_status

Код	Статус
0	STOPPED
1	STOPPING
2	STARTING
3	STARTED