> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intention.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 開發者

> 在 Intention 上開發所需的 API 參考、串接指南、SDK、測試網工具與原始碼，都能在這裡找到入口。

在 Intention 上開發所需的一切，都在下面這些地方。本頁就是地圖。

如果你是第一次串接，先從**串接指南**開始，它會帶你從安裝 SDK 一路走到測試網上的一筆成交。如果你已經清楚系統的整體形狀，只缺欄位層級的細節，直接看 **API 參考**。

<h2 id="start-here">
  從這裡開始
</h2>

<CardGroup cols={2}>
  <Card title="串接指南" icon="book-open" href="https://dev.intention.xyz/">
    完整的開發者流程：安裝、認證與簽章、REST 快速上手、帳戶、行情資料、訂單、交易流程、USDC 轉帳，以及速率限制。
  </Card>

  <Card title="API 參考" icon="plug" href="https://testnet-openapi.intention.xyz/">
    完整的 REST 與 WebSocket 規範，含資料結構定義和瀏覽器內的請求執行器。
  </Card>
</CardGroup>

<h2 id="what-the-api-covers">
  API 涵蓋的範圍
</h2>

參考文件按下列分組組織。端點數量以當前測試網規範為準。

| 分組               | 涵蓋內容                                 |
| ---------------- | ------------------------------------ |
| **Markets**      | 永續市場列表、訂單簿、成交、K 線、資金費率               |
| **Trading**      | 當前掛單、成交記錄、按用戶端訂單 ID 查詢               |
| **Transactions** | 提交、批次提交、模擬、編碼與等待交易；gas 估算            |
| **Accounts**     | 地址與子地址狀態、部位、歷史訂單、歷史成交、轉帳、資金費支付       |
| **DEX Config**   | 永續與現貨定義、手續費設定、槓桿級距、代理人綁定             |
| **Oracle**       | 當前區塊的認證價格                            |
| **Dashboard**    | 帳戶價值、損益序列、交易日曆、彙總                    |
| **Export**       | 歷史訂單、歷史成交與資金費支付的 CSV 匯出              |
| **WebSocket**    | 訂單簿、成交、行情（ticker）、K 線、子帳戶、區塊與交易的訂閱頻道 |

<h2 id="testnet-tools">
  測試網工具
</h2>

面向開發的互動式工具，全部託管在開發者站點上。

<CardGroup cols={2}>
  <Card title="水龍頭" icon="faucet" href="https://dev.intention.xyz/tools-faucet">
    為新帳戶領取測試網資金。
  </Card>

  <Card title="訂單查詢" icon="magnifying-glass" href="https://dev.intention.xyz/tools-order-lookup">
    按 ID 查看任意訂單的狀態與歷史。
  </Card>

  <Card title="WebSocket 測試器" icon="signal-stream" href="https://dev.intention.xyz/tools-websocket">
    訂閱即時頻道並查看原始訊息。
  </Card>

  <Card title="BCS 校驗器" icon="binary" href="https://dev.intention.xyz/tools-bcs-verifier">
    在簽章之前，確認序列化後的交易編碼的確是你預期的內容。
  </Card>
</CardGroup>

<h2 id="sdks-and-source">
  SDK 與原始碼
</h2>

<CardGroup cols={2}>
  <Card title="SDK" icon="cubes" href="https://dev.intention.xyz/installation">
    TypeScript、Go、Python 和 C++ 的官方 SDK——帳戶產生、簽章、訂單構造與轉帳。
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/intentionxyz">
    SDK、節點軟體與參考串接的原始碼。
  </Card>
</CardGroup>

<Note>
  已發布的規範目前針對測試網。端點結構已經穩定到可以據此開發，但在主網發布說明另行交代之前，凡是尚未在主網上跑過的部分，都要當成隨時可能變動。
</Note>

<h2 id="run-a-node">
  運行節點
</h2>

節點運維**不開放**。驗證者集合由 Intention Labs 和受邀夥伴運行，加入方式是審批，不是註冊：沒有公開的加入流程，也沒有開放公眾下載的二進位檔案。

如果你確實需要運行基礎設施，寄信到 `contact@intention.xyz`，主旨行寫 **Node operator**。角色劃分以及信裡應包含哪些資訊，見[運行節點](/zh-Hant/developers/run-a-node)。

<Note>
  想要節點的理由，大多其實是讀取存取的理由——穩定的查詢、歷史資料、不依賴別人的索引器。這些用上面的 API 和[索引器](/zh-Hant/protocol/architecture/indexer)就能滿足，不必自己運維任何東西。
</Note>

<h2 id="getting-help">
  取得協助
</h2>

串接問題、端點行為異常和商務合作，都寄到 `contact@intention.xyz`；信裡該寫什麼，見[開發者與串接問題](/zh-Hant/help/builder-questions)。