获取环境完整配置

客户端版本1.8.0（最新）1.7.0版本概览

GET

示例请求地址http://local.zhongyibrowser.com:39025http://127.0.0.1:39025/api/v1/browsers/{envId}/profile

返回当前用户、当前团队下指定环境的完整公开配置：浏览器内核与当前生效的 User-Agent、指纹、代理、窗口、常用设置、Cookie、已绑定账号和扩展 ID。字段形状与创建 / 编辑环境请求同构，可直接修改后通过 PUT /browsers/{envId} 回传。随机模式的指纹组件只返回模式，不返回后端生成的内部值；代理密码已脱敏为 ******，编辑代理时需重新提供明文密码。响应包含 Cookie，Local API 会返回 Cache-Control: no-store。

请求参数

Authorization Bearer Token

在请求头 Authorization 中使用 Bearer Token 传入 API Key。

Authorization: Bearer <api-key>

Path 参数

1

字段说明

›string必填

浏览器环境唯一标识

示例值"env_01JABCDEF1234567890"

minLength: 1

请求示例代码

JavaScript / TypeScript 使用 Node.js 18+ 内置 fetch；PHP 需启用 cURL 扩展；Go 需 1.16+；Java 需 JDK 11+。运行前请替换 Token 和示例参数值。

curl -H 'Authorization: Bearer <TOKEN>' 'http://local.zhongyibrowser.com:39025/api/v1/browsers/env_01JABCDEF1234567890/profile'

fetch("http://local.zhongyibrowser.com:39025/api/v1/browsers/env_01JABCDEF1234567890/profile", {
  method: "GET",
  headers: {
      "Authorization": "Bearer <TOKEN>"
    },
})
  .then((response) => response.json())
  .then((data) => console.log(data))

async function main(): Promise<void> {
  const options: RequestInit = {
    "method": "GET",
    "headers": {
      "Authorization": "Bearer <TOKEN>"
    }
  }
  const response: Response = await fetch("http://local.zhongyibrowser.com:39025/api/v1/browsers/env_01JABCDEF1234567890/profile", options)
  const data: unknown = await response.json()
  console.log(data)
}

main().catch(console.error)

<?php
$ch = curl_init('http://local.zhongyibrowser.com:39025/api/v1/browsers/env_01JABCDEF1234567890/profile');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer <TOKEN>',
  ],
]);

$response = curl_exec($ch);
if ($response === false) {
  throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
echo $response . PHP_EOL;

package main

import (
	"fmt"
	"io"
	"log"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "http://local.zhongyibrowser.com:39025/api/v1/browsers/env_01JABCDEF1234567890/profile", nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("Authorization", "Bearer <TOKEN>")

	response, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer response.Body.Close()

	data, err := io.ReadAll(response.Body)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
  public static void main(String[] args) throws Exception {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("http://local.zhongyibrowser.com:39025/api/v1/browsers/env_01JABCDEF1234567890/profile"))
        .header("Authorization", "Bearer <TOKEN>")
        .method("GET", HttpRequest.BodyPublishers.noBody())
        .build();

    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  }
}

import requests

url = "http://local.zhongyibrowser.com:39025/api/v1/browsers/env_01JABCDEF1234567890/profile"
headers = {
    "Authorization": "Bearer <TOKEN>"
}

response = requests.get(url, headers=headers)
print(response.json())

返回响应

成功时 code = 0，失败时 code > 0。选择状态码查看对应字段和示例，展开对象可查看嵌套字段；可选字段可能不返回。

指定环境的完整公开配置

Body

响应内容类型application/jsonBrowserProfileDetailSuccessResponse

字段说明

›number必填

业务状态码；成功固定为 0

枚举值

›string必填

业务状态信息；成功固定为 success

枚举值

›object必填

接口业务数据

不允许额外字段。

示例

根据数据模型生成，非实际请求结果。

{
  "code": 0,
  "message": "success",
  "data": {
    "env_id": "env_01JABCDEF1234567890",
    "env_sn": 0,
    "name": "string",
    "sort": 0,
    "remark": "string",
    "command_line": "string",
    "group": {
      "id": "string",
      "name": "string"
    },
    "status": "active",
    "window": {
      "width": 0,
      "height": 0
    },
    "browser": {
      "kernel_version": "string",
      "system_os": "Windows",
      "system_version": "string",
      "ua_version": "string",
      "user_agent": "string"
    },
    "proxy": {
      "mode": "none"
    },
    "fingerprint": {
      "webrtc": {
        "mode": "real"
      },
      "timezone": {
        "mode": "real"
      },
      "geolocation": {
        "mode": "real"
      },
      "language": {
        "mode": "real"
      },
      "screen": {
        "mode": "real"
      },
      "fonts": {
        "mode": "real"
      },
      "noise": {
        "canvas": true,
        "webgl": true,
        "audio_context": true,
        "client_rects": true
      },
      "webgl": {
        "mode": "real"
      },
      "memory": {
        "mode": "real"
      },
      "cpu": {
        "mode": "real"
      },
      "do_not_track": {
        "mode": "default"
      },
      "port_scan_protection": {
        "mode": "disabled"
      },
      "hardware_acceleration": {
        "mode": "default"
      },
      "battery": {
        "mode": "real"
      },
      "media_devices": {
        "mode": "real"
      }
    },
    "common_settings": {
      "image_size_limit_kb": 0,
      "restore_last_session": true,
      "block_video_autoplay": true,
      "disable_video_preload": true,
      "mute_audio": true,
      "disable_translate_prompt": true,
      "disable_password_save_prompt": true,
      "block_notifications": true,
      "block_clipboard_read": true,
      "stop_open_on_network_error": true,
      "stop_open_on_ip_change": true,
      "stop_open_on_country_change": true,
      "search_engine_preset": "360"
    },
    "cookies": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "random_fp_on_open": true,
    "account_ids": [
      "account_01JABCDEF1234567890"
    ],
    "extension_ids": [
      "extension_01JABCDEF1234567890"
    ],
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-01-15T09:30:00Z",
    "last_opened_at": "2024-01-15T09:30:00Z"
  }
}

查看全部业务错误码与 HTTP 状态码