{"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\/es\/guia-completa-sobre-el-uso-de-la-api-de-gemlogin-para-la-automatizacion-del-navegador\/","title":{"rendered":"Una gu\u00eda completa sobre el uso de la API de Gemlogin para la automatizaci\u00f3n del navegador"},"content":{"rendered":"<p><strong>API de inicio de sesi\u00f3n de Gemlogin<\/strong> Es una potente interfaz de programaci\u00f3n de aplicaciones que permite controlar e integrar la plataforma Antidetect Browser de Gemlogin completamente a trav\u00e9s del c\u00f3digo fuente. Con la API de Gemlogin, los perfiles del navegador se crean, configuran, inician, supervisan y cierran instant\u00e1neamente mediante puntos finales HTTP, sin necesidad de manipular la interfaz gr\u00e1fica. Esto ofrece la oportunidad de:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Automatizaci\u00f3n<\/strong>:Crear flujo de trabajo, ejecutar m\u00faltiples perfiles en paralelo.<\/li>\n\n\n\n<li><strong>Integraci\u00f3n flexible<\/strong>:Con\u00e9ctese a CRM, ERP, Google Sheets o cualquier sistema de terceros.<\/li>\n\n\n\n<li><strong>Ampliaci\u00f3n de escala<\/strong>:Administre f\u00e1cilmente miles de perfiles con diferentes huellas dactilares.<\/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. Autenticaci\u00f3n y configuraci\u00f3n general<\/h2>\n\n\n\n<p>Cada solicitud a la API de Gemlogin requiere un encabezado de autenticaci\u00f3n:<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">httpCopiarEditar<code>Autorizaci\u00f3n: al portador<br>Tipo de contenido: aplicaci\u00f3n\/json<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Token al portador<\/strong>:Cons\u00edguelo desde la p\u00e1gina del panel de control de Gemlogin.<\/li>\n\n\n\n<li><strong>Se acab\u00f3 el tiempo<\/strong>:El valor predeterminado es 60 s, se puede personalizar seg\u00fan las necesidades de la aplicaci\u00f3n.<\/li>\n\n\n\n<li><strong>Formato de datos<\/strong>:JSON tanto para solicitud como para respuesta.<\/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. Principales puntos finales<\/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. Versiones del navegador<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>OBTENER \/api\/versiones_del_navegador<\/code><br>Obtenga la lista de versiones de navegadores compatibles (Chrome, Firefox\u2026). jsonCopiarEditar<code>[ { &quot;id&quot;: &quot;chrome_100&quot;, &quot;nombre&quot;: &quot;Chrome&quot;, &quot;versi\u00f3n&quot;: &quot;100.0.4896.127&quot; }, { &quot;id&quot;: &quot;firefox_98&quot;, &quot;nombre&quot;: &quot;Firefox&quot;, &quot;versi\u00f3n&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>OBTENER \/api\/grupos<\/code><br>Consulta de lista <strong>Grupo<\/strong> perfil, conveniente para clasificar y asignar configuraciones comunes. jsonCopyEdit<code>[ { &quot;id&quot;: &quot;grp1&quot;, &quot;name&quot;: &quot;Clientes de EE. UU.&quot; }, { &quot;id&quot;: &quot;grp2&quot;, &quot;name&quot;: &quot;Probadores&quot; } ]<\/code><\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">2.3. Perfiles<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Lista y detalles<\/strong>\n<ul class=\"wp-block-list\">\n<li><code>OBTENER \/api\/perfiles<\/code><br>Obtenga todos los perfiles creados.<\/li>\n\n\n\n<li><code>OBTENER \/api\/perfil\/{id}<\/code><br>Obtener detalles del perfil por <code>{identificaci\u00f3n}<\/code>.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Crear y actualizar<\/strong>\n<ul class=\"wp-block-list\">\n<li><code>POST \/api\/perfiles\/crear<\/code><br>Crear nuevo perfil con ejemplo de carga \u00fatil: jsonCopyEdit<code>{ &quot;nombre&quot;: &quot;Cuenta-FB-1&quot;, &quot;versi\u00f3n-del-navegador&quot;: &quot;chrome_100&quot;, &quot;proxy&quot;: { &quot;host&quot;: &quot;1.2.3.4&quot;, &quot;puerto&quot;: 8000, &quot;nombre-de-usuario&quot;: &quot;&quot;, &quot;contrase\u00f1a&quot;: &quot;&quot; }, &quot;huella-digital&quot;: &quot;predeterminado&quot;, &quot;zona-horaria&quot;: &quot;Am\u00e9rica\/Nueva_York&quot; }<\/code><\/li>\n\n\n\n<li><code>POST \/api\/perfiles\/actualizar\/{id_de_perfil}<\/code><br>Actualizar la configuraci\u00f3n del perfil existente (proxy, huella digital, zona horaria,\u2026).<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Eliminar y cambiar huella digital<\/strong>\n<ul class=\"wp-block-list\">\n<li><code>OBTENER \/api\/profiles\/delete\/{id}<\/code><br>Eliminar perfil por ID.<\/li>\n\n\n\n<li><code>OBTENER \/api\/profiles\/changeFingerprint<\/code><br>Actualice las huellas dactilares de uno o m\u00e1s perfiles, lo que ayuda a evitar el seguimiento a largo plazo.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Iniciar y cerrar la instancia del navegador<\/strong>\n<ul class=\"wp-block-list\">\n<li><code>OBTENER \/api\/profiles\/start\/{id}<\/code><br>Generar una instancia de navegador a partir de un perfil.\n<ul class=\"wp-block-list\">\n<li><strong>Respuesta<\/strong>:URL de WebSocket a controlar (Titiritero, Dramaturgo\u2026).<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><code>OBTENER \/api\/profiles\/close\/{id}<\/code><br>Cerrar (matar) la instancia del navegador en ejecuci\u00f3n del 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. C\u00f3mo utilizar la API en la pr\u00e1ctica<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Ejemplo 1: Crear y ejecutar un perfil<\/h3>\n\n\n\n<pre class=\"wp-block-preformatted\">bashCopiarEditar<code># 1. Crear un nuevo perfil curl -X POST https:\/\/api.gemlogin.io\/api\/profiles\/create \\ -H &quot;Autorizaci\u00f3n: Portador $TOKEN&quot; \\ -H &quot;Tipo de contenido: 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. Iniciar el nuevo perfil curl -X GET https:\/\/api.gemlogin.io\/api\/profiles\/start\/{PROFILE_ID} \\ -H &quot;Autorizaci\u00f3n: Portador $TOKEN&quot;\n<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Ejemplo 2: Ejecuci\u00f3n por lotes con script de 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; async function runProfile(profileId) { const { data } = await axios.get(`${API}\/profiles\/start\/${profileId}`, { headers: { Authorization: `Bearer ${token}` } }); console.log(&#039;URL de WebSocket:&#039;, data.wsUrl); \/\/ Continuar controlando el navegador a trav\u00e9s de Puppeteer\/Playwright... } (async () =&gt; { \/\/ Obtener una lista de perfiles 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. Gesti\u00f3n y seguimiento<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Registros<\/strong>:Utilice el mismo punto final <code>OBTENER \/api\/logs\/{id_de_ejecuci\u00f3n}<\/code> (si est\u00e1 disponible) o mediante SDK para obtener detalles de depuraci\u00f3n.<\/li>\n\n\n\n<li><strong>Estado del recurso<\/strong>:Actualizar el estado del perfil (\u201cActivo\u201d, \u201cInactivo\u201d, \u201cInv\u00e1lido\u201d) para sincronizar con el 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. Consejos y mejores pr\u00e1cticas<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>L\u00edmite de velocidad<\/strong>:El valor predeterminado es ~100 solicitudes por minuto. Si necesita una cantidad mayor, comun\u00edquese con el soporte t\u00e9cnico.<\/li>\n\n\n\n<li><strong>L\u00f3gica de reintento<\/strong>:Manejo de errores 5xx con mecanismo de reintento\/retroceso.<\/li>\n\n\n\n<li><strong>Rotaci\u00f3n de huellas dactilares<\/strong>: Combinar <code>cambiarHuellaDigital<\/code> Peri\u00f3dicamente para aumentar la aleatoriedad.<\/li>\n\n\n\n<li><strong>Configuraci\u00f3n basada en grupos<\/strong>:Cree varios grupos por regi\u00f3n o caso de uso para una f\u00e1cil gesti\u00f3n.<\/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>Con <strong>API de inicio de sesi\u00f3n de Gemlogin<\/strong>, eres completamente proactivo en <strong>integraci\u00f3n<\/strong>, <strong>extender<\/strong> y <strong>\u00f3ptimo<\/strong> Flujo de trabajo de automatizaci\u00f3n del navegador Antidetect. Desde la manipulaci\u00f3n de perfiles y la gesti\u00f3n de huellas dactilares hasta el inicio y cierre de instancias del navegador, todo se puede hacer mediante la l\u00ednea de comandos o c\u00f3digo. \u00a1Comencemos! <strong>API de inicio de sesi\u00f3n de Gemlogin<\/strong> \u00a1Hoy para mejorar el rendimiento, reducir el esfuerzo operativo y optimizar los costos de su proyecto!<\/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>Sitio web: <a href=\"https:\/\/gemlogin.vn\/es\/\" 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 votos)&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\">D\u00e9jame saber lo que piensas<\/span>\n    <\/div>\n    <\/div>","protected":false},"excerpt":{"rendered":"<p>La API de Gemlogin es una potente interfaz de programaci\u00f3n de aplicaciones que permite controlar e integrar la plataforma Antidetect Browser de Gemlogin completamente a trav\u00e9s del c\u00f3digo fuente. Con la API de Gemlogin, los perfiles de navegador se crean, configuran, inician, supervisan y cierran instant\u00e1neamente mediante\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\/es\/wp-json\/wp\/v2\/posts\/2436","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/gemlogin.vn\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/gemlogin.vn\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/gemlogin.vn\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/gemlogin.vn\/es\/wp-json\/wp\/v2\/comments?post=2436"}],"version-history":[{"count":1,"href":"https:\/\/gemlogin.vn\/es\/wp-json\/wp\/v2\/posts\/2436\/revisions"}],"predecessor-version":[{"id":2439,"href":"https:\/\/gemlogin.vn\/es\/wp-json\/wp\/v2\/posts\/2436\/revisions\/2439"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/gemlogin.vn\/es\/wp-json\/wp\/v2\/media\/2438"}],"wp:attachment":[{"href":"https:\/\/gemlogin.vn\/es\/wp-json\/wp\/v2\/media?parent=2436"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/gemlogin.vn\/es\/wp-json\/wp\/v2\/categories?post=2436"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/gemlogin.vn\/es\/wp-json\/wp\/v2\/tags?post=2436"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}