> ## 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.

# API 与集成问题

> 开发者和集成方的问题该去哪里提：API 用法、协议内部机制、商业集成。

本页把开发者和集成方的问题分流到合适的入口。找到符合你情况的类别，按其中的说明操作。

<Note>
  完整的 API 参考发布在 [openapi.intention-testnet.xyz](https://openapi.intention-testnet.xyz)，开发者站点在 [dev.intention.xyz](https://dev.intention.xyz/)。部分接口的数据结构还在调整，所以凡是看起来前后对不上的地方，发邮件比查规范更快。
</Note>

<h2 id="questions-about-api-usage">
  关于 API 用法的问题
</h2>

如果你要赶在参考文档正式发布之前先行集成，请发邮件到 `contact@intention.xyz`，用一句话说明你在做什么、预计会用到哪些接口。集成团队可以给你接口当前的实际形态，并指出哪些地方在上线前可能还会变。

如果你已经在调用某个接口，它的行为却和预期对不上，请发邮件到 `contact@intention.xyz`，附上请求体、响应体、相关的 header，以及调用的 UTC 时间。工单里附上出问题的载荷和实际响应，通常一个来回就能解决——集成团队可以直接拿它们在预发布环境重放。

<h2 id="questions-about-protocol-internals">
  关于协议内部机制的问题
</h2>

如果你想弄清协议为什么这样运作——撮合语义、排序保证、手续费流向、保证金数学、预言机认证——先从本站的架构章节入手。[IntentionKernel](/zh/protocol/architecture/kernel) 一页讲执行；[IntentionBFT](/zh/protocol/architecture/intention-bft) 讲共识；[跨链桥](/zh/protocol/architecture/bridge) 一页讲充值与提现。读完这些之后，如果还剩下架构层面（而不是运维层面）的疑问，请发邮件到 `contact@intention.xyz`，用一段话说明你想理清什么、是从哪一页开始读的。协议团队会分诊这类问题，要么直接回答，要么推动文档改进，让下一个读者不必再问。

<h2 id="commercial-integration">
  商业集成
</h2>

合作、上架、做市协议，以及任何牵涉商业关系的事，都发到 `contact@intention.xyz`。请用一句话说明你在做什么、你是谁，以及你需要 Intention Labs 提供什么才能落地。第一封邮件写清楚，能大幅减少来回沟通。

<h2 id="security-disclosures">
  安全披露
</h2>

安全问题——凡是你不希望在修复之前被互联网上随便什么人看到的东西——请发到 `contact@intention.xyz`，邮件主题里写上 **Security**，这样它会排在普通邮件前面分流。项目规则见[漏洞赏金](/zh/protocol/security/bug-bounty)一页。提交前请先读那一页；按照文档记载的流程操作，才是获得赏金的前提。

<h2 id="summary">
  小结
</h2>

| 事项         | 需要提供什么                                                          |
| ---------- | --------------------------------------------------------------- |
| 某个接口行为异常   | 请求体、响应体、header，以及调用的 UTC 时间                                     |
| 某份协议文档表述含糊 | 你从哪一页读起，以及你想理清什么问题                                              |
| 商业集成       | 你在做什么、你是谁，以及你需要 Intention Labs 提供什么                             |
| 安全披露       | 主题写上 **Security**，并遵循[漏洞赏金](/zh/protocol/security/bug-bounty)流程 |

所有内容都发往 `contact@intention.xyz`。第一封邮件写清楚，能大幅减少来回沟通。