Um guia completo sobre como usar a API Gemlogin para automação de navegador

API Gemlogin é uma poderosa interface de programação de aplicativos que permite controlar e integrar a plataforma Antidetect Browser da Gemlogin inteiramente por meio do código-fonte. Com a API da Gemlogin, os perfis do navegador são criados, configurados, iniciados, monitorados e fechados instantaneamente por meio de endpoints HTTP, sem a necessidade de manipulação da interface gráfica do usuário (GUI). Isso abre a oportunidade de:

• Automação: Crie um fluxo de trabalho, execute vários perfis em paralelo.
• Integração flexível: Conecte-se ao CRM, ERP, Planilhas Google ou qualquer sistema de terceiros.
• Ampliando: Gerencie facilmente milhares de perfis com diferentes impressões digitais.

1. Autenticação e Configuração Geral

Cada solicitação à API Gemlogin requer um cabeçalho de autenticação:

httpCopyEditAutorização: Portador
Tipo de conteúdo: application/json

• Token do Portador: Obtenha-o na página do painel do Gemlogin.
• Tempo esgotado: Padrão 60s, pode ser personalizado de acordo com as necessidades da aplicação.
• Formato de dados: JSON para solicitação e resposta.

2. Principais pontos finais

2.1. Versões do navegador

• OBTER /api/versões_do_navegador
  Obtenha a lista de versões de navegadores compatíveis (Chrome, Firefox…). jsonCopyEdit[ { "id": "chrome_100", "nome": "Chrome", "versão": "100.0.4896.127" }, { "id": "firefox_98", "nome": "Firefox", "versão": "98.0" } // … ]

2.2. Grupos

• OBTER /api/grupos
  Consulta de lista Grupo perfil, conveniente para classificar e atribuir configurações comuns. jsonCopyEdit[ { "id": "grp1", "name": "Clientes dos EUA" }, { "id": "grp2", "name": "Testadores" } ]

2.3. Perfis

1. Lista e detalhes
   • OBTER /api/perfis
     Obtenha todos os perfis criados.
   • OBTER /api/perfil/{id}
     Obtenha detalhes do perfil por {eu ia}.
2. Criar e atualizar
   • POST /api/perfis/criar
     Crie um novo perfil com exemplo de payload: jsonCopyEdit{ "nome": "Conta-FB-1", "versão-do-browser": "chrome_100", "proxy": { "host": "1.2.3.4", "porta": 8000, "nome de usuário": "", "senha": "" }, "impressão digital": "padrão", "fuso-horário": "América/Nova_Iorque" }
   • POST /api/perfis/atualização/{id_do_perfil}
     Atualizar a configuração de perfil existente (proxy, impressão digital, fuso horário,…).
3. Excluir e alterar impressão digital
   • OBTER /api/perfis/delete/{id}
     Excluir perfil por ID.
   • OBTER /api/profiles/changeFingerprint
     Atualize as impressões digitais de um ou mais perfis, ajudando a evitar o rastreamento a longo prazo.
4. Iniciar e fechar instância do navegador
   • OBTER /api/profiles/start/{id}
     Gerar uma instância do navegador a partir de um perfil.
     • Resposta: URL do WebSocket para controlar (Mariteiro, Dramaturgo…).
   • OBTER /api/perfis/fechar/{id}
     Feche (mate) a instância do navegador em execução do perfil.

3. Como usar a API na prática

Exemplo 1: Criar e executar perfil

bashCopyEdit# 1. Crie um novo perfil curl -X POST https://api.gemlogin.io/api/profiles/create \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name":"MyProfile01", "browserVersion":"chrome_100", "proxy":{"host":"proxy.my.com","port":3128}, "fingerprint":"random" }' # 2. Inicie o perfil recém-criado curl -X GET https://api.gemlogin.io/api/profiles/start/{PROFILE_ID} \ -H "Authorization: Bearer $TOKEN"

Exemplo 2: Execução em lote com script Node.js

javascriptCopiarEditarconst axios = require('axios'); const API = 'https://api.gemlogin.io/api'; const token = process.env.GEMLOGIN_TOKEN; função assíncrona runProfile(profileId) { const { dados } = await axios.get(`${API}/profiles/start/${profileId}`, { cabeçalhos: { Autorização: `Portador ${token}` } }); console.log('URL do WebSocket:', dados.wsUrl); // Continue a controlar o navegador via Puppeteer/Playwright... } (async () => { // Obtenha uma lista de perfis const { data: profiles } = await axios.get(`${API}/profiles`, { headers: { Authorization: `Bearer ${token}` } }); for (let p of profiles) { await runProfile(p.id); } })();

4. Gestão e Monitoramento

• Registros: Use o mesmo ponto final OBTER /api/logs/{run_id} (se disponível) ou via SDK para obter detalhes de depuração.
• Status do recurso: Atualizar o status do perfil (“Ativo”, “Inativo”, “Inválido”) para sincronizar com o sistema empresarial.

5. Dicas e práticas recomendadas

1. Limite de taxa: Padrão ~100 solicitações/minuto. Se precisar de mais, entre em contato com o suporte.
2. Lógica de repetição: Tratamento de erros 5xx com mecanismo de nova tentativa/recuo.
3. Rotação de impressão digital: Combinar mudançaImpressão digital periodicamente para aumentar a aleatoriedade.
4. Configuração baseada em grupo: Crie vários grupos por região ou caso de uso para facilitar o gerenciamento.

Concluir

Com API Gemlogin, você é totalmente proativo em integração, estender e Otimizar Fluxo de trabalho de automação do navegador Antidetect. Da manipulação de perfis e gerenciamento de impressões digitais à inicialização e fechamento de instâncias do navegador, tudo pode ser feito por linha de comando ou código. Vamos começar. API Gemlogin hoje para melhorar o desempenho, reduzir o esforço operacional e otimizar os custos do seu projeto!

Documento: https://manual-gemlogin-vn.gitbook.io/gemlogin/tai-lieu-api/api

Site: gemlogin.vn