{"id":2436,"date":"2025-07-19T01:03:33","date_gmt":"2025-07-18T18:03:33","guid":{"rendered":"https:\/\/gemlogin.vn\/?p=2436"},"modified":"2025-07-19T01:03:34","modified_gmt":"2025-07-18T18:03:34","slug":"huong-dan-toan-dien-su-dung-gemlogin-api-cho-tu-dong-hoa-trinh-duyet","status":"publish","type":"post","link":"https:\/\/gemlogin.vn\/pt\/guia-completo-sobre-como-usar-a-api-gemlogin-para-automacao-de-navegador\/","title":{"rendered":"Um guia completo sobre como usar a API Gemlogin para automa\u00e7\u00e3o de navegador"},"content":{"rendered":"<p><strong>API Gemlogin<\/strong> \u00e9 uma poderosa interface de programa\u00e7\u00e3o de aplicativos que permite controlar e integrar a plataforma Antidetect Browser da Gemlogin inteiramente por meio do c\u00f3digo-fonte. Com a API da Gemlogin, os perfis do navegador s\u00e3o criados, configurados, iniciados, monitorados e fechados instantaneamente por meio de endpoints HTTP, sem a necessidade de manipula\u00e7\u00e3o da interface gr\u00e1fica do usu\u00e1rio (GUI). Isso abre a oportunidade de:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Automa\u00e7\u00e3o<\/strong>: Crie um fluxo de trabalho, execute v\u00e1rios perfis em paralelo.<\/li>\n\n\n\n<li><strong>Integra\u00e7\u00e3o flex\u00edvel<\/strong>: Conecte-se ao CRM, ERP, Planilhas Google ou qualquer sistema de terceiros.<\/li>\n\n\n\n<li><strong>Ampliando<\/strong>: Gerencie facilmente milhares de perfis com diferentes impress\u00f5es digitais.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">1. Autentica\u00e7\u00e3o e Configura\u00e7\u00e3o Geral<\/h2>\n\n\n\n<p>Cada solicita\u00e7\u00e3o \u00e0 API Gemlogin requer um cabe\u00e7alho de autentica\u00e7\u00e3o:<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">httpCopyEdit<code>Autoriza\u00e7\u00e3o: Portador<br>Tipo de conte\u00fado: application\/json<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Token do Portador<\/strong>: Obtenha-o na p\u00e1gina do painel do Gemlogin.<\/li>\n\n\n\n<li><strong>Tempo esgotado<\/strong>: Padr\u00e3o 60s, pode ser personalizado de acordo com as necessidades da aplica\u00e7\u00e3o.<\/li>\n\n\n\n<li><strong>Formato de dados<\/strong>: JSON para solicita\u00e7\u00e3o e resposta.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">2. Principais pontos finais<\/h2>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img fetchpriority=\"high\" decoding=\"async\" width=\"1518\" height=\"882\" src=\"https:\/\/gemlogin.vn\/wp-content\/uploads\/2025\/07\/image-6.png\" alt=\"\" class=\"wp-image-2437\" style=\"width:787px;height:auto\" srcset=\"https:\/\/gemlogin.vn\/wp-content\/uploads\/2025\/07\/image-6.png 1518w, https:\/\/gemlogin.vn\/wp-content\/uploads\/2025\/07\/image-6-300x174.png 300w, https:\/\/gemlogin.vn\/wp-content\/uploads\/2025\/07\/image-6-1024x595.png 1024w, https:\/\/gemlogin.vn\/wp-content\/uploads\/2025\/07\/image-6-768x446.png 768w, https:\/\/gemlogin.vn\/wp-content\/uploads\/2025\/07\/image-6-18x10.png 18w\" sizes=\"(max-width: 1518px) 100vw, 1518px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">2.1. Vers\u00f5es do navegador<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>OBTER \/api\/vers\u00f5es_do_navegador<\/code><br>Obtenha a lista de vers\u00f5es de navegadores compat\u00edveis (Chrome, Firefox\u2026). jsonCopyEdit<code>[ { &quot;id&quot;: &quot;chrome_100&quot;, &quot;nome&quot;: &quot;Chrome&quot;, &quot;vers\u00e3o&quot;: &quot;100.0.4896.127&quot; }, { &quot;id&quot;: &quot;firefox_98&quot;, &quot;nome&quot;: &quot;Firefox&quot;, &quot;vers\u00e3o&quot;: &quot;98.0&quot; } \/\/ \u2026 ]<\/code><\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">2.2. Grupos<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>OBTER \/api\/grupos<\/code><br>Consulta de lista <strong>Grupo<\/strong> perfil, conveniente para classificar e atribuir configura\u00e7\u00f5es comuns. jsonCopyEdit<code>[ { &quot;id&quot;: &quot;grp1&quot;, &quot;name&quot;: &quot;Clientes dos EUA&quot; }, { &quot;id&quot;: &quot;grp2&quot;, &quot;name&quot;: &quot;Testadores&quot; } ]<\/code><\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">2.3. Perfis<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Lista e detalhes<\/strong>\n<ul class=\"wp-block-list\">\n<li><code>OBTER \/api\/perfis<\/code><br>Obtenha todos os perfis criados.<\/li>\n\n\n\n<li><code>OBTER \/api\/perfil\/{id}<\/code><br>Obtenha detalhes do perfil por <code>{eu ia}<\/code>.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Criar e atualizar<\/strong>\n<ul class=\"wp-block-list\">\n<li><code>POST \/api\/perfis\/criar<\/code><br>Crie um novo perfil com exemplo de payload: jsonCopyEdit<code>{ &quot;nome&quot;: &quot;Conta-FB-1&quot;, &quot;vers\u00e3o-do-browser&quot;: &quot;chrome_100&quot;, &quot;proxy&quot;: { &quot;host&quot;: &quot;1.2.3.4&quot;, &quot;porta&quot;: 8000, &quot;nome de usu\u00e1rio&quot;: &quot;&quot;, &quot;senha&quot;: &quot;&quot; }, &quot;impress\u00e3o digital&quot;: &quot;padr\u00e3o&quot;, &quot;fuso-hor\u00e1rio&quot;: &quot;Am\u00e9rica\/Nova_Iorque&quot; }<\/code><\/li>\n\n\n\n<li><code>POST \/api\/perfis\/atualiza\u00e7\u00e3o\/{id_do_perfil}<\/code><br>Atualizar a configura\u00e7\u00e3o de perfil existente (proxy, impress\u00e3o digital, fuso hor\u00e1rio,\u2026).<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Excluir e alterar impress\u00e3o digital<\/strong>\n<ul class=\"wp-block-list\">\n<li><code>OBTER \/api\/perfis\/delete\/{id}<\/code><br>Excluir perfil por ID.<\/li>\n\n\n\n<li><code>OBTER \/api\/profiles\/changeFingerprint<\/code><br>Atualize as impress\u00f5es digitais de um ou mais perfis, ajudando a evitar o rastreamento a longo prazo.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Iniciar e fechar inst\u00e2ncia do navegador<\/strong>\n<ul class=\"wp-block-list\">\n<li><code>OBTER \/api\/profiles\/start\/{id}<\/code><br>Gerar uma inst\u00e2ncia do navegador a partir de um perfil.\n<ul class=\"wp-block-list\">\n<li><strong>Resposta<\/strong>: URL do WebSocket para controlar (Mariteiro, Dramaturgo\u2026).<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>OBTER \/api\/perfis\/fechar\/{id}<\/code><br>Feche (mate) a inst\u00e2ncia do navegador em execu\u00e7\u00e3o do perfil.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">3. Como usar a API na pr\u00e1tica<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Exemplo 1: Criar e executar perfil<\/h3>\n\n\n\n<pre class=\"wp-block-preformatted\">bashCopyEdit<code># 1. Crie um novo perfil curl -X POST https:\/\/api.gemlogin.io\/api\/profiles\/create \\ -H &quot;Authorization: Bearer $TOKEN&quot; \\ -H &quot;Content-Type: application\/json&quot; \\ -d &#039;{ &quot;name&quot;:&quot;MyProfile01&quot;, &quot;browserVersion&quot;:&quot;chrome_100&quot;, &quot;proxy&quot;:{&quot;host&quot;:&quot;proxy.my.com&quot;,&quot;port&quot;:3128}, &quot;fingerprint&quot;:&quot;random&quot; }&#039; # 2. Inicie o perfil rec\u00e9m-criado curl -X GET https:\/\/api.gemlogin.io\/api\/profiles\/start\/{PROFILE_ID} \\ -H &quot;Authorization: Bearer $TOKEN&quot;\n<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Exemplo 2: Execu\u00e7\u00e3o em lote com script Node.js<\/h3>\n\n\n\n<pre class=\"wp-block-preformatted\">javascriptCopiarEditar<code>const axios = require(&#039;axios&#039;); const API = &#039;https:\/\/api.gemlogin.io\/api&#039;; const token = process.env.GEMLOGIN_TOKEN; fun\u00e7\u00e3o ass\u00edncrona runProfile(profileId) { const { dados } = await axios.get(`${API}\/profiles\/start\/${profileId}`, { cabe\u00e7alhos: { Autoriza\u00e7\u00e3o: `Portador ${token}` } }); console.log(&#039;URL do WebSocket:&#039;, dados.wsUrl); \/\/ Continue a controlar o navegador via Puppeteer\/Playwright... } (async () =&gt; { \/\/ 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); } })();\n<\/code><\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">4. Gest\u00e3o e Monitoramento<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Registros<\/strong>: Use o mesmo ponto final <code>OBTER \/api\/logs\/{run_id}<\/code> (se dispon\u00edvel) ou via SDK para obter detalhes de depura\u00e7\u00e3o.<\/li>\n\n\n\n<li><strong>Status do recurso<\/strong>: Atualizar o status do perfil (\u201cAtivo\u201d, \u201cInativo\u201d, \u201cInv\u00e1lido\u201d) para sincronizar com o sistema empresarial.<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">5. Dicas e pr\u00e1ticas recomendadas<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Limite de taxa<\/strong>: Padr\u00e3o ~100 solicita\u00e7\u00f5es\/minuto. Se precisar de mais, entre em contato com o suporte.<\/li>\n\n\n\n<li><strong>L\u00f3gica de repeti\u00e7\u00e3o<\/strong>: Tratamento de erros 5xx com mecanismo de nova tentativa\/recuo.<\/li>\n\n\n\n<li><strong>Rota\u00e7\u00e3o de impress\u00e3o digital<\/strong>: Combinar <code>mudan\u00e7aImpress\u00e3o digital<\/code> periodicamente para aumentar a aleatoriedade.<\/li>\n\n\n\n<li><strong>Configura\u00e7\u00e3o baseada em grupo<\/strong>: Crie v\u00e1rios grupos por regi\u00e3o ou caso de uso para facilitar o gerenciamento.<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Concluir<\/h2>\n\n\n\n<p>Com <strong>API Gemlogin<\/strong>, voc\u00ea \u00e9 totalmente proativo em <strong>integra\u00e7\u00e3o<\/strong>, <strong>estender<\/strong> e <strong>Otimizar<\/strong> Fluxo de trabalho de automa\u00e7\u00e3o do navegador Antidetect. Da manipula\u00e7\u00e3o de perfis e gerenciamento de impress\u00f5es digitais \u00e0 inicializa\u00e7\u00e3o e fechamento de inst\u00e2ncias do navegador, tudo pode ser feito por linha de comando ou c\u00f3digo. Vamos come\u00e7ar. <strong>API Gemlogin<\/strong> hoje para melhorar o desempenho, reduzir o esfor\u00e7o operacional e otimizar os custos do seu projeto!<\/p>\n\n\n\n<p>Documento: <a href=\"https:\/\/manual-gemlogin-vn.gitbook.io\/gemlogin\/tai-lieu-api\/api\" target=\"_blank\" rel=\"noopener\">https:\/\/manual-gemlogin-vn.gitbook.io\/gemlogin\/tai-lieu-api\/api<\/a><\/p>\n\n\n\n<p>Site: <a href=\"https:\/\/gemlogin.vn\/pt\/\" data-type=\"link\" data-id=\"https:\/\/gemlogin.vn\/\">gemlogin.vn<\/a><\/p>\n\n\n\n<p><\/p>\n\n\n<div class=\"kk-star-ratings kksr-auto kksr-align-right kksr-valign-bottom\"\n    data-payload='{&quot;align&quot;:&quot;right&quot;,&quot;id&quot;:&quot;2436&quot;,&quot;slug&quot;:&quot;default&quot;,&quot;valign&quot;:&quot;bottom&quot;,&quot;ignore&quot;:&quot;&quot;,&quot;reference&quot;:&quot;auto&quot;,&quot;class&quot;:&quot;&quot;,&quot;count&quot;:&quot;0&quot;,&quot;legendonly&quot;:&quot;&quot;,&quot;readonly&quot;:&quot;&quot;,&quot;score&quot;:&quot;0&quot;,&quot;starsonly&quot;:&quot;&quot;,&quot;best&quot;:&quot;5&quot;,&quot;gap&quot;:&quot;5&quot;,&quot;greet&quot;:&quot;H\u00e3y cho t\u00f4i bi\u1ebft c\u1ea3m nh\u1eadn c\u1ee7a b\u1ea1n&quot;,&quot;legend&quot;:&quot;0\\\/5 - (0 voto)&quot;,&quot;size&quot;:&quot;24&quot;,&quot;title&quot;:&quot;H\u01b0\u1edbng D\u1eabn To\u00e0n Di\u1ec7n S\u1eed D\u1ee5ng Gemlogin API Cho T\u1ef1 \u0110\u1ed9ng H\u00f3a Tr\u00ecnh Duy\u1ec7t&quot;,&quot;width&quot;:&quot;0&quot;,&quot;_legend&quot;:&quot;{score}\\\/{best} - ({count} {votes})&quot;,&quot;font_factor&quot;:&quot;1.25&quot;}'>\n            \n<div class=\"kksr-stars\">\n    \n<div class=\"kksr-stars-inactive\">\n            <div class=\"kksr-star\" data-star=\"1\" style=\"padding-right: 5px\">\n            \n\n<div class=\"kksr-icon\" style=\"width: 24px; height: 24px;\"><\/div>\n        <\/div>\n            <div class=\"kksr-star\" data-star=\"2\" style=\"padding-right: 5px\">\n            \n\n<div class=\"kksr-icon\" style=\"width: 24px; height: 24px;\"><\/div>\n        <\/div>\n            <div class=\"kksr-star\" data-star=\"3\" style=\"padding-right: 5px\">\n            \n\n<div class=\"kksr-icon\" style=\"width: 24px; height: 24px;\"><\/div>\n        <\/div>\n            <div class=\"kksr-star\" data-star=\"4\" style=\"padding-right: 5px\">\n            \n\n<div class=\"kksr-icon\" style=\"width: 24px; height: 24px;\"><\/div>\n        <\/div>\n            <div class=\"kksr-star\" data-star=\"5\" style=\"padding-right: 5px\">\n            \n\n<div class=\"kksr-icon\" style=\"width: 24px; height: 24px;\"><\/div>\n        <\/div>\n    <\/div>\n    \n<div class=\"kksr-stars-active\" style=\"width: 0px;\">\n            <div class=\"kksr-star\" style=\"padding-right: 5px\">\n            \n\n<div class=\"kksr-icon\" style=\"width: 24px; height: 24px;\"><\/div>\n        <\/div>\n            <div class=\"kksr-star\" style=\"padding-right: 5px\">\n            \n\n<div class=\"kksr-icon\" style=\"width: 24px; height: 24px;\"><\/div>\n        <\/div>\n            <div class=\"kksr-star\" style=\"padding-right: 5px\">\n            \n\n<div class=\"kksr-icon\" style=\"width: 24px; height: 24px;\"><\/div>\n        <\/div>\n            <div class=\"kksr-star\" style=\"padding-right: 5px\">\n            \n\n<div class=\"kksr-icon\" style=\"width: 24px; height: 24px;\"><\/div>\n        <\/div>\n            <div class=\"kksr-star\" style=\"padding-right: 5px\">\n            \n\n<div class=\"kksr-icon\" style=\"width: 24px; height: 24px;\"><\/div>\n        <\/div>\n    <\/div>\n<\/div>\n                \n\n<div class=\"kksr-legend\" style=\"font-size: 19.2px;\">\n            <span class=\"kksr-muted\">Deixe-me saber o que voc\u00ea pensa<\/span>\n    <\/div>\n    <\/div>","protected":false},"excerpt":{"rendered":"<p>A API Gemlogin \u00e9 uma poderosa interface de programa\u00e7\u00e3o de aplicativos que permite controlar e integrar a plataforma Antidetect Browser da Gemlogin inteiramente por meio do c\u00f3digo-fonte. Com a API Gemlogin, os perfis do navegador s\u00e3o criados, configurados, iniciados, monitorados e fechados instantaneamente via\u2026<\/p>","protected":false},"author":1,"featured_media":2438,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"categories":[9,8,10],"tags":[14,12,212],"class_list":["post-2436","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tools","category-blog","category-new","tag-antidetect-browser","tag-gemlogin","tag-gemlogin-api"],"_links":{"self":[{"href":"https:\/\/gemlogin.vn\/pt\/wp-json\/wp\/v2\/posts\/2436","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/gemlogin.vn\/pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/gemlogin.vn\/pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/gemlogin.vn\/pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/gemlogin.vn\/pt\/wp-json\/wp\/v2\/comments?post=2436"}],"version-history":[{"count":1,"href":"https:\/\/gemlogin.vn\/pt\/wp-json\/wp\/v2\/posts\/2436\/revisions"}],"predecessor-version":[{"id":2439,"href":"https:\/\/gemlogin.vn\/pt\/wp-json\/wp\/v2\/posts\/2436\/revisions\/2439"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/gemlogin.vn\/pt\/wp-json\/wp\/v2\/media\/2438"}],"wp:attachment":[{"href":"https:\/\/gemlogin.vn\/pt\/wp-json\/wp\/v2\/media?parent=2436"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/gemlogin.vn\/pt\/wp-json\/wp\/v2\/categories?post=2436"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/gemlogin.vn\/pt\/wp-json\/wp\/v2\/tags?post=2436"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}