DocsHTTP Clienthttp_session_create

http_session_create

Http Session Create

Create a persistent HTTP session with automatic cookie management. Cookies received from servers are stored and automatically sent with subsequent requests in the same session. Configure default headers, proxy, user agent, and TLS settings that apply to all requests in the session. Returns a session_id for use with http_session_request and other session tools. Maximum 64 concurrent sessions.

Usage Example

1234567891011

import asyncio

from owl_browser import OwlBrowser, RemoteConfig

# Async usage

async with OwlBrowser(config) as browser:

context = await browser.create_context()

context_id = context["context_id"]

await browser.http_session_create(

)

Parameters

Optional

headersstring

Default HTTP headers as a JSON object or string. Applied to all session requests unless overridden.

user_agentstring

Default User-Agent for all session requests.

follow_redirectsboolean

Default redirect following behavior. Default: true

max_redirectsstring

Default maximum redirects. Default: 10

ssl_verifyboolean

Default SSL verification. Default: true

ca_cert_pathstring

Default CA certificate path for the session.

proxy_typeenum

httphttpssocks4socks5+1 more

Default proxy type for the session.

proxy_hoststring

Default proxy host.

proxy_portstring

Default proxy port.

proxy_usernamestring

Default proxy username.

proxy_passwordstring

Default proxy password.

use_torboolean

Use built-in Tor proxy for all session requests. Default: false

Response

Returns a JSON object with the operation result.

{
  "success": true,
  "result": <value>
}