<!-- 酷可 API 端点页骨架 · 粘贴到 BookStack 页 HTML/源码模式 -->
<!-- 一端点一页 · 甲·浅底方章 · 仅 curl/fetch 静态示例 · 勿嵌试调器 -->
<!-- PRE 20261102apiFoldPre：Header open fold · 请求示例 collapsed fold -->
<div class="cb-api">
  <h1>获取小部件</h1>

  <div class="cb-api-endpoint">
    <span class="cb-api-method cb-api-method--get">GET</span>
    <code class="cb-api-path">/v1/widgets/<var>id</var></code>
  </div>

  <p class="cb-api-meta">operationId: <code>getWidget</code> · 分组: Widgets · 鉴权: Bearer Token</p>

  <p>按 ID 返回单个小部件。路径参数 <code class="cb-api-param">id</code> 为资源主键；响应体字段以本文示例为准（可替换为你的 OAS 示例）。</p>

  <h2>Path 参数</h2>
  <table class="cb-api-table">
    <thead>
      <tr><th>名称</th><th>位置</th><th>类型</th><th>必填</th><th>说明</th></tr>
    </thead>
    <tbody>
      <tr>
        <td><code>id</code></td>
        <td>path</td>
        <td><span class="cb-api-type">string</span></td>
        <td><span class="cb-api-required">必填</span></td>
        <td>小部件 ID</td>
      </tr>
    </tbody>
  </table>

  <details class="cb-api-fold" open>
    <summary>Header 参数</summary>
    <table class="cb-api-table">
      <thead>
        <tr><th>名称</th><th>位置</th><th>类型</th><th>必填</th><th>说明</th></tr>
      </thead>
      <tbody>
        <tr>
          <td><code>Authorization</code></td>
          <td>header</td>
          <td><span class="cb-api-type">string</span></td>
          <td><span class="cb-api-required">必填</span></td>
          <td><code>Bearer &lt;token&gt;</code></td>
        </tr>
      </tbody>
    </table>
  </details>

  <details class="cb-api-fold">
    <summary>请求示例</summary>
    <div class="cb-api-example">
      <span class="cb-api-example__label">curl（静态示例；本页无试调表单）</span>
      <pre><code>curl -sS 'https://api.example.com/v1/widgets/wdg_42'   -H 'Authorization: Bearer YOUR_TOKEN'   -H 'Accept: application/json'</code></pre>
    </div>
    <div class="cb-api-example">
      <span class="cb-api-example__label">fetch</span>
      <pre><code>fetch('https://api.example.com/v1/widgets/wdg_42', {
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'Accept': 'application/json'
  }
}).then(r =&gt; r.json())</code></pre>
    </div>
  </details>

  <h2>响应</h2>
  <h3><span class="cb-api-status">200</span> 成功</h3>
  <div class="cb-api-example">
    <span class="cb-api-example__label">application/json</span>
    <pre><code>{
  "id": "wdg_42",
  "name": "Demo Widget",
  "status": "active",
  "updated_at": "2026-11-02T08:00:00Z"
}</code></pre>
  </div>

  <h3><span class="cb-api-status cb-api-status--err">404</span> 未找到</h3>
  <p>ID 不存在或不在当前鉴权范围。</p>
  <div class="cb-api-example">
    <pre><code>{
  "error": {
    "code": 404,
    "message": "Widget not found"
  }
}</code></pre>
  </div>
</div>