开放接口文档

// 依赖: 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("[关闭] 完成");
    }
}