API de screenshot de websites
Tarefas assíncronas
Os endpoints jobs colocam tarefas de captura de ecrã na fila e permitem consultar o estado e os resultados — ideal para alto volume ou capturas longas.
POST
Tarefas assíncronas
Primeiros passos
URL base
Criar uma tarefa
Coloque na fila uma captura de ecrã assíncrona com o mesmo payloadScreenshotRequest usado pelo endpoint síncrono.
Exemplo de pedido
Parâmetros de criação de tarefa
Object
obrigatório
Um objeto
ScreenshotRequest com os mesmos campos do endpoint síncrono de captura de ecrã (url, render, actions, cookies, etc.).Integer
Prioridade da tarefa. Valores mais altos são processados primeiro. Predefinição: 0.
Obter o estado da tarefa
Consulte uma tarefa por ID para verificar o estado e obter resultados após conclusão.URL base
Exemplo de pedido
Valores de estado da tarefa
Parâmetros de resposta
String
Identificador único da tarefa assíncrona.
String
Estado atual da tarefa:
queued, running, done ou failed.Object
O objeto de resultado da captura (mesma estrutura que a resposta do endpoint síncrono). Presente quando
status é done.String
Mensagem de erro. Presente quando
status é failed.Object
Metadados adicionais sobre a execução da tarefa.
Tarefas assíncronas