API 参考
Hivebrowser 平台的完整 REST API 参考。
访问只放服务端
API 密钥只保存在后端服务、Worker 或密钥管理系统中，不下发到客户端。
运行时每个会话都有边界
设置明确会话超时，并在任务完成后主动停止浏览器。
证据保存 Hivebrowser 标识
把会话、档案、产物和请求 id 写回自己的任务记录，方便排查。
基础地址
REST 端点
https://api.hivebrowser.ai访问
每个请求都需要鉴权
使用团队 API 密钥进行 Bearer 鉴权。不要把密钥暴露在浏览器前端、移动端应用或客户端日志里。
curl -H "Authorization: Bearer hb_your_api_key" \
https://api.hivebrowser.ai/v1/sessions资源
按操作对象选择 API
API 表面保持克制：启动浏览器、保存状态、收集输出、保护访问、监控运行。
上线路径
推荐接入顺序
第一个生产集成保持窄范围：先证明连接，再按需加状态、产物和运维能力。
先创建服务端 API 密钥并跑通一次会话连接；只有需要登录态或稳定上下文时再附加浏览器档案；运行需要证据时捕获截图、PDF 或内容产物；上线后持续查看运行时消耗、运行节点健康和团队设置。