アカウントログイン

  • 1、候鳥ブラウザはローカルAPI機能をサポートしており、ユーザーがプログラムを介してブラウザの起動・終了などの基本機能を操作できるようにします。また、SeleniumやPuppeteerなどの自動化フレームワークと連携して、ブラウザ操作の自動化を実現することも可能です。

  • 2、クライアントV3.9.2.114以上のバージョンのみ対応。最新版をダウンロードしてください。【候鳥ブラウザ最新版をダウンロード】

【HTTP】アカウントログイン

  • HTTPモードはCLIコマンドラインを使用してクライアントを起動する必要があります。参照：【HTTPモードの説明】。または、以下のbatファイルの例を使用して対応するaccount、app_id、app_keyを修正し、apiserver.exeと同じディレクトリに配置することで、apiserverを簡単かつ迅速に実行できます。

apiserver.bat

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

【HTTP】APISERVERとの相互作用・リクエストアドレス詳細

  • Apiserverの起動成功後、以下の方法でApiserverと通信できます

  • http://127.0.0.1:8186 または http://localhost:8186

  • 例えば、アカウントのリアルタイム切り替えと再ログインを行う場合：

  • Post方式 リクエストアドレス：http://127.0.0.1:8186/login

  • POST形式：Content-Type：application/json

  • そしてJSONデータをこのアドレスにPOSTします。Apiserverはリアルタイムで受信し即座に実行します。遅延はありません。

【HTTP】アカウントのリアルタイム切り替えと再ログイン

  • apiserverへのログイン成功後、以下のインターフェースを使用してリアルタイムでアカウントを切り替えることができます

  • 【最大リクエスト頻度：10回/分】

  • Path：/login

  • Method：POST

  • Content-Type：application/json

リクエストパラメータ

以下のパラメータの取得については【注意事項】を参照してください

パラメータ名 タイプ 必須 サンプル/デフォルト値 説明
Account string はい test01@qq.com ユーザー認証 Account
APP_ID string はい 7e147176e1d756eb03c0e18e7b640c23 ユーザー認証 app_Id
APP_KEY string はい kwMTYxNG_MzlkZjhlZmM2YWNiY2M5MTkw ユーザー認証 app_key
return string いいえ on (default)

on: APISERVER.EXE がユーザーに返却するすべてのデータ[JSON/その他]およびすべてのステータス情報を CONSOLE 画面に表示します（未指定時のデフォルト）。

off: データを CONSOLE 画面に表示しません。

logs string いいえ on (default)

on: APISERVER.EXE がユーザーに返却するすべての JSON データおよびステータス情報を API_LOG ディレクトリに明文で書き込みます（ファイル名例：test@qq.com_API_log）。

off: ログを書き込みません。

hide string いいえ on (default)

on: APISERVER.EXE が（全自動）モードで起動します。起動後、ログイン済みの mbbrowser.exe メインパネルを自動的に非表示にし、自動実行中の誤操作によるビジネスリスクを回避します（未指定時のデフォルト）。

off: APISERVER.EXE が（半自動/全自動）モードで起動します。起動後、mbbrowser.exe メインパネルを表示したままにし、手動操作を並行して行うことができます。

［このパラメータはバージョン 4.8.20.134 以降で有効です］

リクエスト例

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

レスポンスパラメータ

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

POSTMANを使用してデバッグする

【HTTP】APISERVERを終了しクライアントを閉じる（ログアウト）

  • Path：/api/v1/quit

  • Method：POST

  • Content-Type：application/json

  • インターフェース説明：APISERVERを停止・終了します。成功時はCode 0を返します。

レスポンスパラメータ

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

POSTMANを使用してデバッグする