APIAutomação Básica do Dolphin {anty}

Automação Básica do Dolphin {anty}

Informações gerais 📜

Os perfis de navegador baseados no mecanismo "Anty" suportam a inicialização ativada pelo protocolo DevTools. Isso permite que você se conecte ao perfil por meio de uma porta gerada na inicialização e automatize o navegador usando ferramentas como Puppeteer, Playwright, Selenium e outras.

Portanto, a automação básica envolve três etapas básicas:

  1. Inicie o perfil por meio da API com o protocolo DevTools ativado
  2. Conecte-se à porta de perfil usando uma ferramenta de automação (Puppeteer, Playwright, Selenium, Postman, etc.).
  3. Execute seu próprio script de automação por meio de uma conexão aberta.

ℹ️ Para usar automação, o Dolphin Anty deve estar em execução e autorizado a funcionar. A autorização pode ser feita por login e senha ou por solicitação de software usando um token. Você pode criar um token em seu gabinete pessoal.

Parâmetros de solicitação para autorização usando token:

Para evitar o erro 401, é necessário enviar a solicitação Method: POST URL: http://localhost:3001/v1.0/auth/login-with-token Header: Content-Type: application/json Body:

{ "token": "API_TOKEN"}

Em qualquer lugar onde houver API_TOKEN, você precisará substituí-lo pelo seu token (chave da API) do seu gabinete pessoal em nosso site.

ChromeDriver ⬇️

O ChromeDriver é a ponte entre seu script (por exemplo, Selenium) e o navegador Dolphin{anty}. O driver padrão pode revelar automação, portanto, fornecemos nosso próprio ChromeDriver modificado para cada versão do navegador.

Download ChromeDriver

Exemplos de solicitação de autorização ⚙️

✅ Se for bem-sucedido, a resposta será:

{"success": true}

Etapa 1 - Iniciar um perfil via API ▶️

Para iniciar um perfil de navegador via API, envie uma solicitação GET:

http://localhost:3001/v1.0/browser_profiles/PROFILE_ID/start?automation=1

Para headless mode:

​http://localhost:3001/v1.0/browser_profiles/PROFILE_ID/start?automation=1&headless=1​
  1. PROFILE_ID - ID do perfil do browser (você pode obtê-lo pormeio da API ou no aplicativo Dolphin{anty} ao editar um perfil).
  2. automation=1 - parâmetro obrigatório.

Exempo de como iniciar uma requisição via Postman

⚠️Notas importantes:

  1. A API local funciona somente se o Dolphin{anty} estiver em execução.
  2. As solicitações devem ser enviadas do mesmo computador em que o navegador é executado.
  3. Por padrão, a API local usa a porta 3001; se estiver ocupada, outra porta será atribuída (verifique na janela Saúde do Dolphin{anty}).
  4. No plano gratuito, a importação/exportação de cookies via API não está disponível devido à ausência de sincronização na nuvem.

API response

Se o perfil tiver sido iniciado com êxito, a resposta terá aproximadamente a seguinte aparência (os valores dos campos port e wsEndpoint podem variar):

{
 "success": true,
  "automation": {
    "port": 50568,
    "wsEndpoint": "/devtools/browser/c71c1a9d-f07c-4dd9-84a9-53a4c6df9969" }}​

Etapa 2 Conectando a um perfil 🔌

Puppeteer

Puppeteer — Biblioteca popular do Google para automação e teste da interface do usuário do navegador. Originalmente criada para iniciar o Chrome e verificar a interface do usuário, mas suporta quase todas as ações do navegador. Requer conhecimento de JavaScript/Node.js.

Playwright

Playwright vs Selenium: What are the Main Differences and Which is Better?  - Applitools
Playwright vs Selenium: What are the Main Differences and Which is Better? - Applitools

Playwright - Uma alternativa mais nova e moderna ao Puppeteer, só que desenvolvida pela Microsoft com API e funcionalidade semelhantes.

Selenium

Selenium - Testautomatisierung.org
Selenium - Testautomatisierung.org

A conexão do Selenium a um navegador em execução é descrita neste artigo. Vale a pena observar que o Selenium usa o ChromeDriver padrão, mas os sites podem detectar a automação. Portanto, recomendamos o uso de nosso ChromeDriver — faça o download e especifique o caminho em seu código para ocultar o uso do Selenium.

Etapa 3 Interromper um perfil ⛔️

Para interromper um perfil de navegador via API, envie uma GET request:

 http://localhost:3001/v1.0/browser_profiles/PROFILE_ID/stop