> ## 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/developers/run-a-node)。

<Note>
  想要一个节点的理由，大多其实是想要读取权限——稳定的查询、历史数据、不依赖别人的索引器。这些用上面的 API 和[索引器](/zh/protocol/architecture/indexer)就能满足，不必自己运维任何东西。
</Note>

<h2 id="getting-help">
  获取帮助
</h2>

集成问题、端点行为异常和商务合作，都发到 `contact@intention.xyz`——邮件里该写什么，见[开发者与集成问题](/zh/help/builder-questions)。