> ## 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 與串接問題

> 關於 Intention 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-Hant/protocol/architecture/kernel) 一頁講執行；[IntentionBFT](/zh-Hant/protocol/architecture/intention-bft) 講共識；[跨鏈橋](/zh-Hant/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-Hant/protocol/security/bug-bounty)一頁。提交前先讀那一頁；按照文件記載的流程操作，才是獲得賞金的前提。

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

| 事項         | 需要提供什麼                                                               |
| ---------- | -------------------------------------------------------------------- |
| 某個端點行為異常   | 請求主體、回應主體、header，以及呼叫的 UTC 時間                                        |
| 某份協議文件表述含糊 | 你從哪一頁讀起，以及你想理清什麼問題                                                   |
| 商業串接       | 你在做什麼、你是誰，以及你需要 Intention Labs 提供什麼                                  |
| 安全揭露       | 主旨寫上 **Security**，並遵循[漏洞賞金](/zh-Hant/protocol/security/bug-bounty)流程 |

所有內容都寄往 `contact@intention.xyz`。第一封信寫清楚，能大幅減少來回溝通。