Files
opsxapi/homepage/dist/docs/http/index.html
T
logan dbf15c3060 移除 /docs/quickstart 文档页(公测期安装口径与获取方式尚未定稿,暂不公开)
- 删除 02-quickstart.md 与 manifest 目录条目(21→20 页)
- 原指向该页的入口全部改指 /docs 文档首页(落地页 hero 次级按钮、三站页脚)
- intro 提示改指《界面导览》;重建后 /docs/quickstart 404、全站零死链引用
2026-10-16 13:30:33 +08:00

226 lines
8.7 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>发送 HTTP 请求 · OpsxAPI 文档</title>
<meta name="description" content="OpsxAPI 接口工作台用户文档 — HTTP、GraphQL、WebSocket、SSE、Socket.IO、MQTT 一站式调试,支持 OpenAPI/Postman/cURL 等格式导入导出。">
<link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='7' fill='%232563eb'/%3E%3Ctext x='16' y='22' font-size='18' font-weight='bold' fill='%23fff' text-anchor='middle' font-family='sans-serif'%3EO%3C/text%3E%3C/svg%3E">
<link rel="icon" type="image/svg+xml" href="data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%2064%2064%22%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22g%22%20x1%3D%220%22%20y1%3D%220%22%20x2%3D%2264%22%20y2%3D%2264%22%20gradientUnits%3D%22userSpaceOnUse%22%3E%3Cstop%20offset%3D%220%22%20stop-color%3D%22%232563EB%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22%2306B6D4%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D%2264%22%20height%3D%2264%22%20rx%3D%2214%22%20fill%3D%22url%28%23g%29%22%2F%3E%3Cg%20stroke%3D%22%23fff%22%20stroke-width%3D%225%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%20fill%3D%22none%22%3E%3Cpath%20d%3D%22M17%2025h26%22%2F%3E%3Cpath%20d%3D%22M37%2019l6%206-6%206%22%2F%3E%3Cpath%20d%3D%22M47%2039H21%22%2F%3E%3Cpath%20d%3D%22M27%2033l-6%206%206%206%22%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E">
<link rel="stylesheet" href="/docs/assets/docs.css">
</head>
<body>
<svg xmlns="http://www.w3.org/2000/svg" style="display:none" aria-hidden="true">
<symbol id="i-menu" viewBox="0 0 24 24"><path d="M4 5h16" /> <path d="M4 12h16" /> <path d="M4 19h16" /></symbol>
<symbol id="i-search" viewBox="0 0 24 24"><path d="m21 21-4.34-4.34" /> <circle cx="11" cy="11" r="8" /></symbol>
</svg>
<header class="topbar">
<div class="topbar-inner">
<button class="menu-btn" id="menu-btn" aria-label="打开导航"><svg class="i"><use href="#i-menu"/></svg></button>
<a class="brand" href="/docs">
<span class="brand-logo"><svg width="28" height="28" viewBox="0 0 64 64" aria-label="OpsxAPI"><defs><linearGradient id="lg-docs" x1="0" y1="0" x2="64" y2="64" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#2563EB"/><stop offset="1" stop-color="#06B6D4"/></linearGradient></defs><rect width="64" height="64" rx="14" fill="url(#lg-docs)"/><g stroke="#fff" stroke-width="5" stroke-linecap="round" stroke-linejoin="round" fill="none"><path d="M17 25h26"/><path d="M37 19l6 6-6 6"/><path d="M47 39H21"/><path d="M27 33l-6 6 6 6"/></g></svg></span>
<span class="brand-name">OpsxAPI <em>文档</em></span>
</a>
<span class="ver-badge">v1.0</span>
<div class="search">
<input id="search-input" type="search" placeholder="搜索文档…" autocomplete="off" spellcheck="false">
<div class="search-panel" id="search-panel" hidden></div>
</div>
<nav class="top-links">
<a href="/home">官网</a>
</nav>
</div>
</header>
<div class="layout" id="layout">
<aside class="sidebar" id="sidebar">
<div class="nav-group">
<div class="nav-group-title">开始使用</div>
<a class="nav-link" href="/docs/intro">产品介绍</a>
<a class="nav-link" href="/docs/interface">界面导览</a>
</div>
<div class="nav-group">
<div class="nav-group-title">请求调试</div>
<a class="nav-link active" href="/docs/http">发送 HTTP 请求</a>
<a class="nav-link" href="/docs/auth">接口鉴权</a>
<a class="nav-link" href="/docs/env">环境与变量</a>
<a class="nav-link" href="/docs/graphql">GraphQL</a>
<a class="nav-link" href="/docs/websocket">WebSocket</a>
<a class="nav-link" href="/docs/sse">SSE 事件流</a>
<a class="nav-link" href="/docs/socketio">Socket.IO</a>
<a class="nav-link" href="/docs/mqtt">MQTT</a>
</div>
<div class="nav-group">
<div class="nav-group-title">数据管理</div>
<a class="nav-link" href="/docs/import">数据导入</a>
<a class="nav-link" href="/docs/export">导出与代码生成</a>
<a class="nav-link" href="/docs/mock">Mock 数据</a>
<a class="nav-link" href="/docs/manage">集合与历史</a>
</div>
<div class="nav-group">
<div class="nav-group-title">自动化测试与 AI</div>
<a class="nav-link" href="/docs/testing">自动化测试</a>
<a class="nav-link" href="/docs/ai">AI 助手</a>
</div>
<div class="nav-group">
<div class="nav-group-title">账号与团队</div>
<a class="nav-link" href="/docs/account">账号与团队</a>
</div>
<div class="nav-group">
<div class="nav-group-title">参考</div>
<a class="nav-link" href="/docs/license">授权与激活</a>
<a class="nav-link" href="/docs/server-api">服务端 API 参考</a>
<a class="nav-link" href="/docs/faq">常见问题</a>
</div>
<div class="sidebar-foot">© 2026 OpsxAPI · 本地优先的接口工作台</div>
</aside>
<main class="content">
<div class="breadcrumb">文档 <span>/</span> 请求调试 <span>/</span> 发送 HTTP 请求</div>
<h1 class="page-title">发送 HTTP 请求</h1>
<div class="page-meta">更新于 2026-09-17</div>
<article class="md">
<h2 id="sec-1">发送请求</h2>
<ol>
<li>选择方法(GET / POST / PUT / PATCH / DELETE / HEAD / OPTIONS)。</li>
<li>输入 URL,支持 <code>{{baseUrl}}/path</code> 形式的变量(见《环境与变量》)。</li>
<li>点击 <strong>发送</strong>,或直接在 URL 输入框按 <strong>Enter</strong>。</li>
</ol>
<p>请求默认经本地代理(<code>/v1/proxy/http</code>)发出,天然绕开浏览器 CORS 限制。</p>
<h2 id="sec-2">Params(查询参数)</h2>
<p>键值对编辑器,每行可勾选启用 / 停用、填写说明。URL 中已有的查询串会被拆分到表格里,两边双向同步。</p>
<h2 id="sec-3">Body(请求体)</h2>
<table>
<thead>
<tr>
<th>模式</th>
<th>适用场景</th>
</tr>
</thead>
<tbody>
<tr>
<td>none</td>
<td>GET 等无体请求</td>
</tr>
<tr>
<td>JSON</td>
<td>REST 接口(默认自动补 <code>Content-Type: application/json</code>,带格式化按钮)</td>
</tr>
<tr>
<td>XML / Text / HTML</td>
<td>原始报文</td>
</tr>
<tr>
<td>x-www-form-urlencoded</td>
<td>表单提交</td>
</tr>
<tr>
<td>form-data</td>
<td>multipart 文本字段(文件上传请用代码生成的 cURL)</td>
</tr>
</tbody>
</table>
<h2 id="sec-4">Headers / Cookies</h2>
<ul>
<li>Headers:键值对,支持 <code>{{变量}}</code>;<code>Authorization</code>、<code>Cookie</code> 由 Auth / Cookies 标签统一管理时避免重复。</li>
<li>Cookies:键值对,发送时自动拼接为 <code>Cookie</code> 请求头。</li>
</ul>
<h2 id="sec-5">代码生成</h2>
<p>点击 URL 栏右侧 <strong><code>&lt;/&gt;</code> 代码</strong>,可生成:</p>
<ul>
<li>cURL(可直接在终端执行)</li>
<li>JavaScript fetch</li>
<li>Python requests</li>
<li>Go net/http</li>
</ul>
<p>生成内容保留 <code>{{变量}}</code> 原样,便于粘贴到脚本后再替换。</p>
<h2 id="sec-6">响应面板</h2>
<table>
<thead>
<tr>
<th>标签</th>
<th>内容</th>
</tr>
</thead>
<tbody>
<tr>
<td>响应体</td>
<td>JSON 自动格式化 + 语法高亮;其他类型原样展示</td>
</tr>
<tr>
<td>Raw</td>
<td>未格式化的原始文本</td>
</tr>
<tr>
<td>响应头</td>
<td>全部响应头表格</td>
</tr>
</tbody>
</table>
<p>右上角常驻 <strong>状态码 / 耗时 / 大小 / Content-Type</strong>,并提供「复制体」按钮。</p>
</article>
<div class="pn-nav">
<a class="pn prev" href="/docs/interface"><span class="pn-label">← 上一页</span><span class="pn-title">界面导览</span></a>
<a class="pn next" href="/docs/auth"><span class="pn-label">下一页 →</span><span class="pn-title">接口鉴权</span></a>
</div>
</main>
<aside class="toc">
<div class="toc-title">本页目录</div>
<nav class="toc-nav">
<a class="toc-l2" href="#sec-1">发送请求</a>
<a class="toc-l2" href="#sec-2">Params(查询参数)</a>
<a class="toc-l2" href="#sec-3">Body(请求体)</a>
<a class="toc-l2" href="#sec-4">Headers / Cookies</a>
<a class="toc-l2" href="#sec-5">代码生成</a>
<a class="toc-l2" href="#sec-6">响应面板</a>
</nav>
</aside>
</div>
<script src="/docs/assets/docs.js" defer></script>
</body>
</html>