Connexion au Compte

  • 1、Le Navigateur HouNiao prend en charge les fonctions d'API locale, aidant les utilisateurs à démarrer et à fermer le navigateur et d'autres fonctions d'API de base de manière programmatique, et peut également être utilisé avec des frameworks d'automatisation tels que Selenium et Puppeteer pour automatiser les opérations du navigateur.

  • 2、Prend en charge uniquement les versions du client supérieures à V3.9.2.114, veuillez télécharger la dernière version du client【Télécharger la dernière version du Navigateur HouNiao】

【HTTP】Connexion au compte

  • Le mode http nécessite l'utilisation de la ligne de commande CLI pour démarrer le client, voir【Description du Mode HTTP】, vous pouvez également utiliser l'exemple de fichier bat ci-dessous pour modifier les account, app_id et app_key correspondants et le placer dans le même répertoire que apiserver.exe pour lancer facilement et rapidement apiserver.

apiserver.bat

ApiServer.exe --port=8186 --account=test04@qq.com --app_id=7e147176e1d756eb03c0e18e7b640c23 --app_key=ExOTNjMWNWYzZTU5ZjYzMGEzZDU4ZDI3 --return=on --logs=on

【HTTP】Interaction avec APISERVER, détails de l'adresse de requête

  • Une fois qu'Apiserver fonctionne avec succès, vous pouvez utiliser les méthodes suivantes pour communiquer avec Apiserver

  • http://127.0.0.1:8186 Ou http://localhost:8186

  • Par exemple, pour changer de compte et se reconnecter en temps réel, vous pouvez :

  • Adresse de requête via POST :http://127.0.0.1:8186/login

  • Format POST :Content-Type：application/json

  • Ensuite, envoyez vos données json via POST à cette adresse, Apiserver les recevra et les exécutera en temps réel, sans aucun délai.

【HTTP】Basculer de compte et se reconnecter en temps réel

  • Après une connexion réussie à apiserver, vous pouvez utiliser l'interface suivante pour changer de compte en temps réel

  • 【Fréquence de requête maximale : 10 fois/minute】

  • Path：/login

  • Method：POST

  • Content-Type：application/json

Paramètres de requête

L'obtention des paramètres ci-dessous peut se faire sur【Précautions d'Emploi】Consulter

Nom du paramètre Type Obligatoire Chaîne d'exemple/Valeur par défaut Explication
Account string Oui test01@qq.com Identifiants de l'utilisateur Account
APP_ID string Oui 7e147176e1d756eb03c0e18e7b640c23 Identifiants de l'utilisateur app_Id
APP_KEY string Oui kwMTYxNG_MzlkZjhlZmM2YWNiY2M5MTkw Identifiants de l'utilisateur app_key
return string Non on (default)

on : APISERVER.EXE toutes les données à renvoyer à l'utilisateur [JSON/Autres], toutes les informations de statut, reviennent à l'interface CONSOLE. (Lorsque l'utilisateur ne remplit pas ce paramètre, la valeur par défaut est ON)

off : Toutes les données renvoyées à l'utilisateur [JSON/Autres], toutes les informations de statut, ne sont pas affichées dans l'interface CONSOLE.

logs string Non on (default)

on : APISERVER.EXE toutes les données JSON à renvoyer à l'utilisateur, toutes les informations de statut, sont écrites en texte clair dans le répertoire API_LOG [et non le répertoire LOG], exemple de préfixe de fichier LOG : test@qq.com_API_log. (Lorsque l'utilisateur ne remplit pas ce paramètre, la valeur par défaut est ON)

off : Toutes les données JSON renvoyées au script, toutes les informations de statut, ne sont pas écrites dans le LOG.

hide string Non on (default)

on : APISERVER.EXE démarre en mode (entièrement automatisé). Après le démarrage, il masquera automatiquement le panneau principal de mbbrowser.exe déjà connecté, garantissant ainsi que le client évite les risques commerciaux causés par une manipulation manuelle simultanée de l'environnement via le panneau principal pendant l'exécution automatisée. (Lorsque l'utilisateur ne remplit pas ce paramètre, la valeur par défaut est ON)

off : APISERVER.EXE démarre dans un mode qui prend en charge le mode (semi-automatisé/entièrement automatisé). Après le démarrage, il affichera le panneau principal de mbbrowser.exe, permettant au client de contrôler l'environnement manuellement via le panneau principal pendant l'exécution automatisée, renforçant ainsi la capacité de contrôle commercial.

[Ce paramètre n'est valide que pour les versions du produit : 4.8.20.134 et ultérieures]

Exemple de requête

{
    "APP_ID": "7e147176e1d756eb03c0e18e7b640c23",
    "APP_KEY": "kwMTYxNG_MzlkZjhlZmM2YWNiY2M5MTkw",
    "Account": "test01@qq.com"
}

Paramètres de retour

{
    "msg": "Login Success",
    "status": 0,
    "data": "Login Aaccount: test01@qq.com"
}

Déboguer cette interface avec POSTMAN

【HTTP】Quitter APISERVER et fermer le client (Déconnexion)

  • Path：/api/v1/quit

  • Method：POST

  • Content-Type：application/json

  • Description de l'interface : Arrête et ferme APISERVER, renvoie le code 0 en cas de succès.

Paramètres de retour

{
    "message": "APISERVER shut down.",
    "code": 0,
    "data": true
}

Déboguer cette interface avec POSTMAN