Una guía completa sobre el uso de la API de Gemlogin para la automatización del navegador

API de inicio de sesión de Gemlogin Es una potente interfaz de programación de aplicaciones que permite controlar e integrar la plataforma Antidetect Browser de Gemlogin completamente a través del código fuente. Con la API de Gemlogin, los perfiles del navegador se crean, configuran, inician, supervisan y cierran instantáneamente mediante puntos finales HTTP, sin necesidad de manipular la interfaz gráfica. Esto ofrece la oportunidad de:

• Automatización:Crear flujo de trabajo, ejecutar múltiples perfiles en paralelo.
• Integración flexible:Conéctese a CRM, ERP, Google Sheets o cualquier sistema de terceros.
• Ampliación de escala:Administre fácilmente miles de perfiles con diferentes huellas dactilares.

1. Autenticación y configuración general

Cada solicitud a la API de Gemlogin requiere un encabezado de autenticación:

httpCopiarEditarAutorización: al portador
Tipo de contenido: aplicación/json

• Token al portador:Consíguelo desde la página del panel de control de Gemlogin.
• Se acabó el tiempo:El valor predeterminado es 60 s, se puede personalizar según las necesidades de la aplicación.
• Formato de datos:JSON tanto para solicitud como para respuesta.

2. Principales puntos finales

2.1. Versiones del navegador

• OBTENER /api/versiones_del_navegador
  Obtenga la lista de versiones de navegadores compatibles (Chrome, Firefox…). jsonCopiarEditar[ { "id": "chrome_100", "nombre": "Chrome", "versión": "100.0.4896.127" }, { "id": "firefox_98", "nombre": "Firefox", "versión": "98.0" } // … ]

2.2. Grupos

• OBTENER /api/grupos
  Consulta de lista Grupo perfil, conveniente para clasificar y asignar configuraciones comunes. jsonCopyEdit[ { "id": "grp1", "name": "Clientes de EE. UU." }, { "id": "grp2", "name": "Probadores" } ]

2.3. Perfiles

1. Lista y detalles
   • OBTENER /api/perfiles
     Obtenga todos los perfiles creados.
   • OBTENER /api/perfil/{id}
     Obtener detalles del perfil por {identificación}.
2. Crear y actualizar
   • POST /api/perfiles/crear
     Crear nuevo perfil con ejemplo de carga útil: jsonCopyEdit{ "nombre": "Cuenta-FB-1", "versión-del-navegador": "chrome_100", "proxy": { "host": "1.2.3.4", "puerto": 8000, "nombre-de-usuario": "", "contraseña": "" }, "huella-digital": "predeterminado", "zona-horaria": "América/Nueva_York" }
   • POST /api/perfiles/actualizar/{id_de_perfil}
     Actualizar la configuración del perfil existente (proxy, huella digital, zona horaria,…).
3. Eliminar y cambiar huella digital
   • OBTENER /api/profiles/delete/{id}
     Eliminar perfil por ID.
   • OBTENER /api/profiles/changeFingerprint
     Actualice las huellas dactilares de uno o más perfiles, lo que ayuda a evitar el seguimiento a largo plazo.
4. Iniciar y cerrar la instancia del navegador
   • OBTENER /api/profiles/start/{id}
     Generar una instancia de navegador a partir de un perfil.
     • Respuesta:URL de WebSocket a controlar (Titiritero, Dramaturgo…).
   • OBTENER /api/profiles/close/{id}
     Cerrar (matar) la instancia del navegador en ejecución del perfil.

3. Cómo utilizar la API en la práctica

Ejemplo 1: Crear y ejecutar un perfil

bashCopiarEditar# 1. Crear un nuevo perfil curl -X POST https://api.gemlogin.io/api/profiles/create \ -H "Autorización: Portador $TOKEN" \ -H "Tipo de contenido: application/json" \ -d '{ "name":"MyProfile01", "browserVersion":"chrome_100", "proxy":{"host":"proxy.my.com","port":3128}, "fingerprint":"random" }' # 2. Iniciar el nuevo perfil curl -X GET https://api.gemlogin.io/api/profiles/start/{PROFILE_ID} \ -H "Autorización: Portador $TOKEN"

Ejemplo 2: Ejecución por lotes con script de Node.js

javascriptCopiarEditarconst axios = require('axios'); const API = 'https://api.gemlogin.io/api'; 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('URL de WebSocket:', data.wsUrl); // Continuar controlando el navegador a través de Puppeteer/Playwright... } (async () => { // 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); } })();

4. Gestión y seguimiento

• Registros:Utilice el mismo punto final OBTENER /api/logs/{id_de_ejecución} (si está disponible) o mediante SDK para obtener detalles de depuración.
• Estado del recurso:Actualizar el estado del perfil (“Activo”, “Inactivo”, “Inválido”) para sincronizar con el sistema empresarial.

5. Consejos y mejores prácticas

1. Límite de velocidad:El valor predeterminado es ~100 solicitudes por minuto. Si necesita una cantidad mayor, comuníquese con el soporte técnico.
2. Lógica de reintento:Manejo de errores 5xx con mecanismo de reintento/retroceso.
3. Rotación de huellas dactilares: Combinar cambiarHuellaDigital Periódicamente para aumentar la aleatoriedad.
4. Configuración basada en grupos:Cree varios grupos por región o caso de uso para una fácil gestión.

Concluir

Con API de inicio de sesión de Gemlogin, eres completamente proactivo en integración, extender y óptimo Flujo de trabajo de automatización del navegador Antidetect. Desde la manipulación de perfiles y la gestión de huellas dactilares hasta el inicio y cierre de instancias del navegador, todo se puede hacer mediante la línea de comandos o código. ¡Comencemos! API de inicio de sesión de Gemlogin ¡Hoy para mejorar el rendimiento, reducir el esfuerzo operativo y optimizar los costos de su proyecto!

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

Sitio web: gemlogin.vn