指纹浏览器API - 企业级浏览器自动化解决方案

完整的API接口文档

提供涵盖浏览器管理、指纹、代理、Cookie、JavaScript、页面导航、元素操作、网络监听、文件上传等全方位的API接口

浏览器管理接口

POST /api/browser/create

创建浏览器实例，支持指纹、代理、窗口设置

POST /api/browser/create-custom-window

创建自定义窗口浏览器

POST /api/browser/close

关闭指定浏览器

GET /api/browser/list

获取所有活跃浏览器列表

POST /api/browser/hide

隐藏浏览器窗口

POST /api/browser/show

显示浏览器窗口

GET /api/browser/main-window-handle

获取主窗口句柄

使用示例

快速上手，几行代码即可完成浏览器自动化操作，支持多种主流编程语言

创建浏览器

const response = await fetch('http://localhost:9001/api/browser/create', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    title: '测试浏览器',
    url: 'https://www.baidu.com',
    width: 1200,
    height: 800,
    imageLoading: true
  })
});

const result = await response.json();
console.log(result.browserId); // 获取浏览器ID

网络监听

await fetch('http://localhost:9001/api/browser/listen/start', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ browserId: '12345' })
});

const response = await fetch('http://localhost:9001/api/browser/listen/wait', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ browserId: '12345' })
});

const packet = await response.json();
console.log(packet.packet.responseBody); // 响应内容

执行JavaScript

const response = await fetch('http://localhost:9001/api/browser/execute-js-with-result', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    browserId: '12345',
    jsCode: 'document.title',
    timeout: 5000
  })
});

const result = await response.json();
console.log(result.result); // 页面标题

创建浏览器

import requests
import json

# 创建浏览器
response = requests.post(
    'http://localhost:9001/api/browser/create',
    headers={'Content-Type': 'application/json'},
    data=json.dumps({
        'title': '测试浏览器',
        'url': 'https://www.baidu.com',
        'width': 1200,
        'height': 800,
        'imageLoading': True
    })
)

result = response.json()
print(result['browserId'])  # 获取浏览器ID

网络监听

# 开始监听
requests.post(
    'http://localhost:9001/api/browser/listen/start',
    headers={'Content-Type': 'application/json'},
    data=json.dumps({'browserId': '12345'})
)

# 等待数据包
response = requests.post(
    'http://localhost:9001/api/browser/listen/wait',
    headers={'Content-Type': 'application/json'},
    data=json.dumps({'browserId': '12345'})
)

packet = response.json()
print(packet['packet']['responseBody'])  # 响应内容

执行JavaScript

response = requests.post(
    'http://localhost:9001/api/browser/execute-js-with-result',
    headers={'Content-Type': 'application/json'},
    data=json.dumps({
        'browserId': '12345',
        'jsCode': 'document.title',
        'timeout': 5000
    })
)

result = response.json()
print(result['result'])  # 页面标题

创建浏览器

import java.net.http.*;
import java.net.URI;

HttpClient client = HttpClient.newHttpClient();
String requestBody = """{"title":"测试浏览器","url":"https://www.baidu.com","width":1200,"height":800,"imageLoading":true}""";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("http://localhost:9001/api/browser/create"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(requestBody))
    .build();

HttpResponse<String> response = client.send(request, 
    HttpResponse.BodyHandlers.ofString());

System.out.println(response.body()); // 打印响应

网络监听

// 开始监听
String startBody = """{"browserId":"12345"}""";
HttpRequest startRequest = HttpRequest.newBuilder()
    .uri(URI.create("http://localhost:9001/api/browser/listen/start"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(startBody))
    .build();
client.send(startRequest, HttpResponse.BodyHandlers.ofString());

// 等待数据包
HttpRequest waitRequest = HttpRequest.newBuilder()
    .uri(URI.create("http://localhost:9001/api/browser/listen/wait"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(startBody))
    .build();
HttpResponse<String> waitResponse = client.send(
    waitRequest, HttpResponse.BodyHandlers.ofString());
System.out.println(waitResponse.body());

执行JavaScript

String jsBody = """{"browserId":"12345","jsCode":"document.title","timeout":5000}""";
HttpRequest jsRequest = HttpRequest.newBuilder()
    .uri(URI.create("http://localhost:9001/api/browser/execute-js-with-result"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(jsBody))
    .build();

HttpResponse<String> jsResponse = client.send(
    jsRequest, HttpResponse.BodyHandlers.ofString());
System.out.println(jsResponse.body()); // 执行结果

创建浏览器

using System.Net.Http;
using System.Text;

HttpClient client = new HttpClient();
string requestBody = @"{""title"":""测试浏览器"",""url"":""https://www.baidu.com"",""width"":1200,""height"":800,""imageLoading"":true}";

var content = new StringContent(requestBody, Encoding.UTF8, "application/json");
var response = await client.PostAsync(
    "http://localhost:9001/api/browser/create", content);

string result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result); // 打印响应

网络监听

// 开始监听
string startBody = @"{""browserId"":""12345""}";
var startContent = new StringContent(startBody, Encoding.UTF8, "application/json");
await client.PostAsync("http://localhost:9001/api/browser/listen/start", startContent);

// 等待数据包
string waitBody = @"{""browserId"":""12345""}";
var waitContent = new StringContent(waitBody, Encoding.UTF8, "application/json");
var waitResponse = await client.PostAsync(
    "http://localhost:9001/api/browser/listen/wait", waitContent);
string waitResult = await waitResponse.Content.ReadAsStringAsync();
Console.WriteLine(waitResult);

执行JavaScript

string jsBody = @"{""browserId"":""12345"",""jsCode"":""document.title"",""timeout"":5000}";
var jsContent = new StringContent(jsBody, Encoding.UTF8, "application/json");
var jsResponse = await client.PostAsync(
    "http://localhost:9001/api/browser/execute-js-with-result", jsContent);
string jsResult = await jsResponse.Content.ReadAsStringAsync();
Console.WriteLine(jsResult); // 执行结果

创建浏览器

<?php
$data = [
    'title' => '测试浏览器',
    'url' => 'https://www.baidu.com',
    'width' => 1200,
    'height' => 800,
    'imageLoading' => true
];

$ch = curl_init('http://localhost:9001/api/browser/create');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);

$response = curl_exec($ch);
curl_close($ch);
echo $response; // 打印响应
?>

网络监听

// 开始监听
$startData = ['browserId' => '12345'];
$ch = curl_init('http://localhost:9001/api/browser/listen/start');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($startData));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_exec($ch);
curl_close($ch);

// 等待数据包
$ch = curl_init('http://localhost:9001/api/browser/listen/wait');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($startData));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

执行JavaScript

$jsData = [
    'browserId' => '12345',
    'jsCode' => 'document.title',
    'timeout' => 5000
];

$ch = curl_init('http://localhost:9001/api/browser/execute-js-with-result');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($jsData));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$response = curl_exec($ch);
curl_close($ch);
echo $response; // 执行结果

创建浏览器

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    data := map[string]interface{}{
        "title":        "测试浏览器",
        "url":          "https://www.baidu.com",
        "width":        1200,
        "height":       800,
        "imageLoading": true,
    }
    jsonData, _ := json.Marshal(data)

    resp, _ := http.Post(
        "http://localhost:9001/api/browser/create",
        "application/json",
        bytes.NewBuffer(jsonData),
    )
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result) // 打印响应
}

网络监听

// 开始监听
startData := map[string]interface{}{"browserId": "12345"}
startJson, _ := json.Marshal(startData)
http.Post("http://localhost:9001/api/browser/listen/start", 
    "application/json", bytes.NewBuffer(startJson))

// 等待数据包
waitData := map[string]interface{}{"browserId": "12345"}
waitJson, _ := json.Marshal(waitData)
resp, _ := http.Post("http://localhost:9001/api/browser/listen/wait",
    "application/json", bytes.NewBuffer(waitJson))
defer resp.Body.Close()

var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result)

执行JavaScript

jsData := map[string]interface{}{
    "browserId": "12345",
    "jsCode":   "document.title",
    "timeout":  5000,
}
jsJson, _ := json.Marshal(jsData)
resp, _ := http.Post("http://localhost:9001/api/browser/execute-js-with-result",
    "application/json", bytes.NewBuffer(jsJson))
defer resp.Body.Close()

var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result) // 执行结果

创建浏览器

require 'net/http'
require 'json'

uri = URI('http://localhost:9001/api/browser/create')
data = {
  title: '测试浏览器',
  url: 'https://www.baidu.com',
  width: 1200,
  height: 800,
  imageLoading: true
}

response = Net::HTTP.post(uri, data.to_json, 'Content-Type' => 'application/json')
puts response.body # 打印响应

网络监听

# 开始监听
start_uri = URI('http://localhost:9001/api/browser/listen/start')
start_data = { browserId: '12345' }
Net::HTTP.post(start_uri, start_data.to_json, 'Content-Type' => 'application/json')

# 等待数据包
wait_uri = URI('http://localhost:9001/api/browser/listen/wait')
wait_response = Net::HTTP.post(wait_uri, start_data.to_json, 'Content-Type' => 'application/json')
puts wait_response.body

执行JavaScript

js_uri = URI('http://localhost:9001/api/browser/execute-js-with-result')
js_data = {
  browserId: '12345',
  jsCode: 'document.title',
  timeout: 5000
}

js_response = Net::HTTP.post(js_uri, js_data.to_json, 'Content-Type' => 'application/json')
puts js_response.body # 执行结果

指纹浏览器 API接口

指纹伪装

网络监听

代理支持

JavaScript执行

元素操作

窗口控制

完整的API接口文档

浏览器管理接口

指纹管理接口

代理设置接口

Cookie管理接口

JavaScript执行接口

页面导航接口

元素操作接口

网络监听接口

文件上传接口

核心功能特性

指纹伪装

网络监听

窗口控制

JavaScript执行

文件上传

Swagger UI集成

Swagger UI 文档

交互式API文档

使用示例

联系我们

电子邮件

QQ/微信