Ir para o conteúdo principal

FAQ a API

A documentação detalhada da API pode ser encontrada em https://documenter.getpostman.com/view/1801428/UVC6i6eA

É possível 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 que precisar em massa. Isso pode ser feito codificando um loop em uma linguagem de programação com a qual você se sinta à vontade, usando um arquivo de texto com cookies e outros dados necessários que podem ser processados ou divididos por meio de métodos de linguagem de programação e, em seguida, passando sequencialmente esses parâmetros para a solicitação de criação de perfil.

A automação com estruturas de automação de navegador, como Puppeteer, Pyppeteer, Playwright ou Selenium, está disponível no Octo?​

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 você tiver mais de 100 perfis em 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. Você pode implementar isso codificando um loop na linguagem de programação de sua escolha.

Ao enviar uma solicitação GET para esse URL, você terá 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

Atualmente, não é possível exportar totalmente todos os cookies de perfil usando a API. Só é possível exportar cookies da página aberta usando estruturas de automação (Selenium, Puppeteer, Playwright).

O suporte técnico não pode ajudar nem consultar sobre como obter cookies da página aberta em um perfil usando uma estrutura de automação do navegador.

O erro 429 ocorre 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, você 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 - O momento UNIX após o qual o limite será redefinido

IMPORTANTE! Não envie solicitações se 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?​

Você precisa usar o driver Chromium com uma versão que corresponda à versão atual de kernel do Octo. Você pode ver a versão atual do kernel digitando chrome://version na barra de endereços de um perfil de execução. Se um driver para o kernel mais recente ainda não tiver sido lançado, use o driver da 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, somente a solicitação Start Profile será contabilizada nos limites de RPM (solicitações por minuto) e RPH (solicitações por hora).

As seguintes solicitações não são contadas para os limites de solicitações:

  • Listar perfis ativos,
  • Parar perfil,
  • Forçar a parada do perfil,
  • Fazer login,
  • Sair,
  • Obter a versão do cliente,
  • Atualizar cliente

Como posso obter o UUID das extensões?​

O senhor pode obter o UUID das extensões de três maneiras:

A primeira maneira:​

  1. Adicione a extensão manualmente a qualquer perfil por meio da edição de perfil.
  2. Obtenha os parâmetros desse perfil por meio da API usando uma solicitação GET Get Profile.
  3. Na resposta do servidor, você verá as configurações de perfil, incluindo os UUIDs das extensões conectadas.

A segunda maneira:​

Use uma solicitação GET Get Extensions de nosso site documentation.

A terceira maneira:​

  1. Abra um perfil com a extensão conectada.
  2. Digite chrome://extensions/ na barra de endereços do perfil e pressione Enter.
  3. Clique no botão "Details" da extensão necessária.
  4. Copie o UUID da extensão junto com sua versão do campo Source abaixo.

Como posso obter o UUID de um ícone?​

  1. Salve o ícone em qualquer perfil.
  2. Execute uma solicitação GET Get Profile em nossa documentação para recuperar informações sobre o perfil no qual você salvou o ícone.
  3. Você 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 abra em seu tamanho máximo quando o perfil for iniciado via API, você pode usar o sinalizador start-maximized nos argumentos de início do perfil.

flags: ["--start-maximized"]

É possível alterar o endereço IP do proxy com sua API?​

Se o seu proxy fornecer um link de alteração de endereço IP, você poderá fazer uma solicitação GET regular 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 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"]

Infelizmente, não é possível iniciar o Cookie Robot usando a API. Se você usar a API, poderá implementar facilmente funcionalidades semelhantes ou até mais avançadas usando estruturas de automação (Puppeteer, Playwright, Selenium).