Pular para o conteúdo principal
POST
Criar uma sessão de interação

Cabeçalhos

CabeçalhoValor
AuthorizationBearer <API_KEY>
Content-Typeapplication/json

Corpo da Requisição

ParâmetroTipoObrigatórioPadrãoDescrição
ttlnumberNão600Tempo de vida total da sessão, em segundos (30-3600)
activityTtlnumberNão300Número de segundos de inatividade antes que a sessão seja destruída (10-3600)
profileobjectNãoHabilita armazenamento persistente entre sessões. Veja abaixo.
profile.namestringSim*Nome do perfil (1-128 caracteres). Sessões com o mesmo nome compartilham o armazenamento.
profile.saveChangesbooleanNãotrueQuando true, o estado do navegador é salvo de volta no perfil ao fechar. Defina como false para carregar dados existentes sem gravar. Apenas um salvamento é permitido por vez.

Resposta

CampoTipoDescrição
successbooleanIndica se a sessão foi criada
idstringIdentificador único da sessão
cdpUrlstringURL WebSocket para conexões CDP
liveViewUrlstringURL para assistir à sessão em tempo real
interactiveLiveViewUrlstringURL para interagir com a sessão em tempo real (clicar, digitar, rolar)
expiresAtstringQuando a sessão expira com base no TTL

Exemplo de requisição

Resposta de exemplo

Você é um agente de IA que precisa de uma chave de API do Firecrawl? Consulte firecrawl.dev/agent-onboarding/SKILL.md para obter instruções de onboarding automatizado.

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Corpo

application/json
activityTtl
integer

Tempo, em segundos, antes que a sessão seja encerrada por inatividade

Intervalo obrigatório: 10 <= x <= 3600
profile
object

Ativa o armazenamento persistente entre sessões de interação. Os dados salvos em uma sessão podem ser carregados em uma sessão posterior usando o mesmo nome.

streamWebView
boolean
padrão:true

Se deve transmitir uma visualização em tempo real do navegador

ttl
integer
padrão:300

Tempo de vida total, em segundos, da sessão de interação

Intervalo obrigatório: 30 <= x <= 3600

Resposta

Sessão de interação criada com sucesso

cdpUrl
string

URL do WebSocket para acesso ao Chrome DevTools Protocol

expiresAt
string<date-time>

Quando a sessão expirará com base no TTL

id
string

O identificador único da sessão

interactiveLiveViewUrl
string

URL para interagir com a sessão de interação em tempo real (clicar, digitar, rolar)

liveViewUrl
string

URL para visualizar a sessão de interação em tempo real

success
boolean