API: FAQ
A documentação detalhada da API pode ser encontrada em https://documenter.getpostman.com/view/1801428/UVC6i6eA
Posso criar perfis em massa e adicionar cookies, extensões ou atribuir tags a eles?
Você pode usar nossa API para criar perfis com cookies e configurações específicas de que precisa em massa. Isso pode ser feito ao programar um loop na linguagem de sua preferência, usando um arquivo de texto com cookies e outros dados necessários que podem ser processados ou divididos com métodos da linguagem de programação e, em seguida, passar esses parâmetros sequencialmente para a solicitação de criação de perfil.
O Octo Browser oferece suporte a bibliotecas e estruturas de automação, como Puppeteer, Pyppeteer, Playwright e Selenium?
Sim, você pode usar essas estruturas de automação. Você pode encontrar exemplos de código para iniciar um perfil e conectar uma estrutura/biblioteca a um perfil de execução em nossa documentação da API.
Iniciei um perfil usando a API, vejo "Auto" no botão "START" no aplicativo de clientes Octo, mas não vejo a interface do perfil.
Verifique os argumentos iniciais do perfil e, especificamente, o parâmetro headless. Para que a interface do perfil seja exibida, esse parâmetro deve ser definido como falso.
É possível obter todos os nomes de perfis em uma conta usando a API?
Sim, você pode usar o método GET Get Profiles da nossa documentação da API para fazer isso.
Se o senhor tiver mais de 100 perfis na sua conta, precisará alterar o número da página solicitada no URL da solicitação e também definir os parâmetros de saída dos campos como título. O senhor pode implementar isso codificando um loop na linguagem de programação de sua escolha.
Ao enviar uma solicitação GET para esse URL, você receberá o UUID e o título de 100 perfis na primeira página.
https://app.octobrowser.net/api/v2/automation/profiles?page_len=100&page=0&fields=title
É possível exportar todos os cookies de perfil usando a API?
Atualmente, não é possível exportar totalmente todos os cookies de perfil usando a API. Só é possível exportar cookies da página atualmente aberta usando estruturas de automação (Selenium, Puppeteer, Playwright).
O Atendimento ao Cliente não pode oferecer consultoria nem ajudar você a obter cookies da página aberta em um perfil usando uma estrutura de automação do navegador.
Recebo o erro 429 ao executar uma solicitação
Interrompa seu script e faça uma pausa nas solicitações. Os limites da API para sua conta podem ser encontrados nos cabeçalhos de resposta do servidor correspondentes.
Retry-After: 0 # Se esse valor for igual a 0, o senhor poderá enviar a próxima solicitação
X-Ratelimit-Limit: 200 # RPM - A quantidade total de solicitações por minuto
X-Ratelimit-Limit-Hour: 3000 # RPH - A quantidade total de solicitações por hora
X-Ratelimit-Remaining: 4 # remaining RPM - Solicitações restantes por minuto
X-Ratelimit-Remaining-Hour: 2999 # remaining RPH - Solicitações restantes por hora
X-Ratelimit-Reset: 1671789217 # unix timestamp - hora UNIX após a qual o limite será redefinido
IMPORTANTE!
Não envie solicitações se o senhor tiver esgotado seus limites: o tempo de restrição será estendido e restrições mais rigorosas poderão ser aplicadas. Verifique os cabeçalhos de limite em seus scripts antes de enviar uma solicitação.
Qual driver devo usar para o Selenium?
O senhor precisa usar o driver Chromium com uma versão que corresponda à versão atual do kernel Octo. O senhor pode ver a versão atual do kernel digitando chrome://version na barra de endereços de um perfil em execução. Se um driver para o kernel mais recente ainda não tiver sido lançado, use o driver para a versão anterior.
Quais solicitações à API local serão contabilizadas no limite de solicitações permitidas?
De todas as solicitações disponíveis na coluna API local, os limites de RPM (solicitações por minuto) e RPH (solicitações por hora) são afetados pelo seguinte:
- Iniciar perfil, que conta como 1 solicitação.
- Perfil de uso único, que conta como 4 solicitações.
As seguintes solicitações não são contadas para os limites de solicitações:
- Listar perfis ativos,
- Interromper perfil,
- Forçar a interrupção do perfil,
- Fazer login,
- Sair,
- Obter a versão do cliente,
- Atualizar cliente,
- Nome de usuário,
- Definir a senha do perfil,
- Excluir a senha do perfil.
Como posso obter o UUID das extensões?
Você pode obter o UUID das extensões de três maneiras:
O primeiro método:
- Adicionar a extensão manualmente a qualquer perfil por meio da edição de perfil.
- Obtenha os parâmetros desse perfil por meio da API usando uma solicitação GET Get Profile.
- Na resposta do servidor, o senhor verá as configurações de perfil, incluindo os UUIDs dos ramais conectados.
O segundo método:
Use uma solicitação GET Get Extensions de nossa documentação.
O terceiro método:
- Abra um perfil com a extensão conectada.
- Digite chrome://extensions/ na barra de endereços do perfil e pressione Enter.
- Clique no botão "Details" (Detalhes) da extensão necessária.
- Copie o UUID da extensão junto com sua versão do campo Source (Fonte) abaixo.
Como posso obter o UUID de um ícone?
- Salvar o ícone em qualquer perfil.
- Execute uma solicitação GET Get Profile em nossa documentação para recuperar informações sobre o perfil no qual o senhor salvou o ícone.
- O senhor encontrará o UUID desse ícone na resposta do servidor no campo "image", que pode ser usado para adicionar o ícone a outros perfis.
Como posso fazer com que um perfil abra em tamanho real na inicialização?
Para fazer com que a janela do perfil inicie em seu tamanho máximo quando o perfil for iniciado via API, o senhor pode usar o sinalizador --start-maximized nos argumentos de início do perfil.
flags: ["--start-maximized"]
É possível alterar o IP do proxy pela API?
Se o seu proxy tiver um link para mudar o endereço IP, você poderá fazer uma solicitação GET padrão usando esse link. Nossa API não é necessária para isso.
Um exemplo de solicitação Python com a biblioteca de solicitações:
import requests
response = requests.get('link para alteração de endereço IP')
Um exemplo de solicitação do Node.js com a biblioteca Axios:
const axios = require('axios');
axios.get('link para alteração do endereço IP');
Ao usar a automação paralela de vários perfis ao mesmo tempo, os scripts não funcionam corretamente em janelas que estão fora de foco (em segundo plano).
Tente adicionar o sinalizador --disable-backgrounding-occluded-windows aos argumentos de inicialização de seus perfis.
Por exemplo:
flags:["--disable-backgrounding-occluded-windows"]
É possível iniciar o Cookie Robot via API?
O Cookie Robot não pode ser iniciado via API. Se o senhor usar a API, poderá implementar facilmente funcionalidades semelhantes ou até mais avançadas usando estruturas de automação (Puppeteer, Playwright, Selenium).
Passagem de parâmetros ao criar um perfil via API
const body = {
title: "profile_title", /* campo obrigatório */
fingerprint: {
os: "mac", /* campo obrigatório, ou "win" */
os_arch: "arm", /* campo opcional, ou "x86", se o senhor quiser criar um perfil mac com CPU Intel*/
os_version: "13" /* campo opcional
para perfis win - 10/11,
para mac arm - 12/13/14/15,
para mac x86 (Intel) - 12/13/14/15
*/
}
}
Passagem de parâmetros adicionais em uma solicitação de criação de perfil:
- Para obter informações detalhadas, consulte a nossa documentação de API. Selecione a solicitação POST Create Profile e role para baixo até o bloco de código Body, onde o senhor pode ver a estrutura dos parâmetros aceitos.
- Crie um perfil e recupere seus parâmetros usando a solicitação GET Get Profile. Na resposta do servidor, o senhor verá a estrutura e os parâmetros do perfil.
Como adiciono páginas iniciais a perfis já criados em massa?
Você pode usar nossa API para fazer isso. Você precisará obter os UUIDs dos perfis necessários e fazer uma solicitação PATCH de atualização de perfil para cada perfil que for passar pelas páginas iniciais exigidas. Nossa documentação da API oferece snippets para essas tarefas. Você pode modificá-los de acordo com sua tarefa específica.
Posso gerenciar tarefas de perfil usando a API?
No momento, não oferecemos a funcionalidade de API para gerenciar tarefas de perfil.