开放接口文档

# 依赖: pip install requests playwright
# playwright install chromium
import requests

BASE = "http://127.0.0.1:9001"

def get(path, **params):
    r = requests.get(BASE + path, params=params)
    r.raise_for_status()
    return r.json()

def post(path, **body):
    r = requests.post(BASE + path, json=body)
    r.raise_for_status()
    return r.json()

# ── 新增环境（使用自定义手动代理；代理不需要 name）──────────────────────
print("[环境] 正在新增环境...")
res = post("/open/env/create",
    name="账号-01",
    browser_version="138.0.7204.184",  # 推荐显式传入；不传则自动取最新，需先在管理界面下载对应版本
    proxy_mode="custom",
    custom_proxy={
        "input_type": "manual",
        "type": "http",
        "addr": "127.0.0.1",
        "port": 7890,
        "username": "user",
        "password": "pass",
    },
    timezone="custom",     timezone_value="Asia/Shanghai",
    geo_location="custom", longitude="116.3", latitude="39.9",
    language="custom",     languages=["zh-CN", "en-US"],
    cpu_cores="8", memory_gb="16",
)
print("[环境] 结果:", res)
env_code = res["data"]["code"]
print(f"[环境] code={env_code}")

# ── 刷新指纹 ───────────────────────────────────────────────────────────────
print("[指纹] 正在随机刷新指纹...")
res = post("/open/env/randomize_fingerprint", code=env_code)
print("[指纹] 结果:", res["data"])

# ── 打开浏览器（headless=False 显示窗口）─────────────────────────────────
print("[浏览器] 正在打开浏览器...")
res = post("/open/env/open", code=env_code, headless=False)
print("[浏览器] 结果:", res)
debug_port = res["data"]["debug_port"]
print(f"[浏览器] 调试端口={debug_port}")

# ── 接入 Playwright ────────────────────────────────────────────────────────
print("[Playwright] 正在连接...")
try:
    from playwright.sync_api import sync_playwright
    with sync_playwright() as p:
        browser = p.chromium.connect_over_cdp(f"http://127.0.0.1:{debug_port}")
        page = browser.contexts[0].new_page()
        page.goto("https://www.baidu.com")
        title = page.title()
        print(f"[Playwright] 页面标题={title}")

except Exception as e:
    print(f"[错误] Playwright 执行失败: {str(e)}")
    raise

finally:
    print(f"[批量] 获取浏览器状态 {env_code}...")
    r = get("/open/env/status", code=env_code)
    print(f"状态结果={r}")
    print("[关闭] 正在执行兜底关闭...")
    post("/open/env/close", code=env_code)
    print("[关闭] 完成")

# ── 批量查询环境列表 ───────────────────────────────────────────────────────
print("[批量] 查询环境列表...")
res = get("/open/env/list", page=1, page_size=10)
for env in res["data"]["items"]:
    print(f"环境结果={env}")

// 依赖: npm install playwright  (Node 18+ 内置 fetch，无需额外安装)
const BASE = "http://127.0.0.1:9001";

const get = async (path, params = {}) => {
  const qs = new URLSearchParams(params).toString();
  const r = await fetch(`${BASE}${path}${qs ? "?" + qs : ""}`);
  return r.json();
};

const post = async (path, body = {}) => {
  const r = await fetch(BASE + path, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(body),
  });
  return r.json();
};

(async () => {
  // ── 新增代理 ──────────────────────────────────────────────────────────
  console.log("[代理] 正在新增代理...");
  let res = await post("/open/proxy/create", {
    proxy_name: "美国住宅-01", proxy_type: "socks5",
    proxy_addr: "1.2.3.4",   proxy_port: 1080,
    username: "user",         password: "pass",
  });
  console.log("[代理] 结果:", res);
  const proxyCode = res.data.code;

  // ── 新增环境 ──────────────────────────────────────────────────────────
  console.log("[环境] 正在新增环境...");
  res = await post("/open/env/create", {
    name: "账号-01",
    // proxy_ip_code: proxyCode,  // 如需绑定代理取消注释
    timezone: "custom",     timezone_value: "Asia/Shanghai",
    geo_location: "custom", longitude: "116.3", latitude: "39.9",
    language: "custom",     languages: ["zh-CN", "en-US"],
    cpu_cores: "8", memory_gb: "16",
  });
  console.log("[环境] 结果:", res);
  const envCode = res.data.code;

  // ── 刷新指纹 ──────────────────────────────────────────────────────────
  console.log("[指纹] 正在随机刷新指纹...");
  res = await post("/open/env/randomize_fingerprint", { code: envCode });
  console.log("[指纹] 结果:", res.data);

  // ── 打开浏览器 ────────────────────────────────────────────────────────
  console.log("[浏览器] 正在打开浏览器...");
  res = await post("/open/env/open", { code: envCode, headless: true });
  console.log("[浏览器] 结果:", res);
  const debugPort = res.data.debug_port;

  // ── 接入 Playwright ───────────────────────────────────────
  const { chromium } = require("playwright");
  let browser = null;
  try {
    browser = await chromium.connectOverCDP(`http://127.0.0.1:${debugPort}`);
    const page = browser.contexts()[0].pages()[0];
    await page.goto("https://www.example.com");
    console.log("[Playwright] 页面标题=", await page.title());
  } catch (err) {
    console.error("[Playwright] 执行失败:", err.message);
    throw err;
  } finally {
    if (browser) await browser.close().catch(() => {});
    await post("/open/env/close", { code: envCode }).catch(() => {});
    console.log("[关闭] 完成");
  }
})();

// 依赖: JDK 11+（内置 java.net.http.HttpClient）
//   org.json:json:20231013
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import org.json.JSONObject;

public class QiyuanDemo {

    static final String BASE = "http://127.0.0.1:9001";
    static final HttpClient client = HttpClient.newHttpClient();

    static JSONObject get(String path) throws Exception {
        var req = HttpRequest.newBuilder()
            .uri(URI.create(BASE + path))
            .GET().build();
        var resp = client.send(req, HttpResponse.BodyHandlers.ofString());
        return new JSONObject(resp.body());
    }

    static JSONObject post(String path, JSONObject body) throws Exception {
        var req = HttpRequest.newBuilder()
            .uri(URI.create(BASE + path))
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body.toString()))
            .build();
        var resp = client.send(req, HttpResponse.BodyHandlers.ofString());
        return new JSONObject(resp.body());
    }

    public static void main(String[] args) throws Exception {

        // ── 新增代理 ──────────────────────────────────────────────────
        System.out.println("[代理] 正在新增代理...");
        JSONObject proxyRes = post("/open/proxy/create", new JSONObject()
            .put("proxy_name", "美国住宅-01").put("proxy_type", "socks5")
            .put("proxy_addr", "1.2.3.4").put("proxy_port", 1080)
            .put("username", "user").put("password", "pass"));
        System.out.println("[代理] 结果: " + proxyRes);
        String proxyCode = proxyRes.getJSONObject("data").getString("code");

        // ── 新增环境 ──────────────────────────────────────────────────
        System.out.println("[环境] 正在新增环境...");
        JSONObject envRes = post("/open/env/create", new JSONObject()
            .put("name", "账号-01")
            // .put("proxy_ip_code", proxyCode)  // 如需绑定代理取消注释
            .put("timezone", "custom").put("timezone_value", "Asia/Shanghai")
            .put("geo_location", "custom").put("longitude", "116.3").put("latitude", "39.9")
            .put("language", "custom").put("languages", new org.json.JSONArray().put("zh-CN").put("en-US"))
            .put("cpu_cores", "8").put("memory_gb", "16"));
        System.out.println("[环境] 结果: " + envRes);
        String envCode = envRes.getJSONObject("data").getString("code");

        // ── 刷新指纹 ──────────────────────────────────────────────────
        System.out.println("[指纹] 正在随机刷新指纹...");
        JSONObject fpRes = post("/open/env/randomize_fingerprint",
            new JSONObject().put("code", envCode));
        System.out.println("[指纹] 结果: " + fpRes.opt("data"));

        // ── 打开浏览器 ────────────────────────────────────────────────
        System.out.println("[浏览器] 正在打开浏览器...");
        JSONObject openRes = post("/open/env/open", new JSONObject()
            .put("code", envCode).put("headless", true));
        System.out.println("[浏览器] 结果: " + openRes);
        int debugPort = openRes.getJSONObject("data").getInt("debug_port");
        System.out.println("[浏览器] 调试端口=" + debugPort);

        // ── 接入 Playwright (com.microsoft.playwright) ────────────────
        // Playwright pw = Playwright.create();
        // Browser browser = pw.chromium()
        //     .connectOverCDP("http://127.0.0.1:" + debugPort);
        // Page page = browser.contexts().get(0).newPage();
        // page.navigate("https://www.example.com");
        // System.out.println("[Playwright] 标题=" + page.title());

        // ── 关闭浏览器 ────────────────────────────────────────────────
        System.out.println("[关闭] 正在关闭浏览器...");
        post("/open/env/close", new JSONObject().put("code", envCode));
        System.out.println("[关闭] 完成");
    }
}