> ## 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`宛に、何を作っているのかを一行で説明し、必要になりそうなエンドポイントを添えて送ってください。連携チームが現時点のインターフェースの形を共有し、ローンチ前に変わりそうな箇所を指摘できます。

すでにエンドポイントに対して動かしていて、想定と異なる挙動をする場合は、リクエストボディ、レスポンスボディ、関連するヘッダー、呼び出したUTC時刻を添えて`contact@intention.xyz`に送ってください。問題のペイロードと観測されたレスポンスが引用されているチケットは、連携チームがステージング環境でそのまま再現できるため、たいてい一往復で解決します。

<h2 id="questions-about-protocol-internals">
  プロトコル内部に関する質問
</h2>

マッチングのセマンティクス、順序保証、手数料の流れ、証拠金の計算、オラクルの認証など、プロトコルがなぜそのように振る舞うのかを理解しようとしている場合は、このサイトのアーキテクチャ節から読んでください。[IntentionKernel](/ja/protocol/architecture/kernel)のページが実行を、[IntentionBFT](/ja/protocol/architecture/intention-bft)のページがコンセンサスを、[ブリッジ](/ja/protocol/architecture/bridge)のページが入金と出金を扱っています。これらを読んだうえで、運用面ではなくアーキテクチャに関する疑問が残る場合は、何について考えようとしているのかを一段落でまとめ、どのページから読み始めたかを添えて`contact@intention.xyz`に送ってください。プロトコルチームがそうした質問を仕分けし、直接回答するか、次の読者が同じ質問をしなくて済むようにドキュメントの改善を手配します。

<h2 id="commercial-integration">
  商用連携
</h2>

提携、上場、マーケットメイク契約など、ビジネス上の関係を伴うものはすべて`contact@intention.xyz`宛です。何を作っているのか、送り主が何者か、Intention Labsに何を求めるのかを一行で添えてください。最初のメッセージが明確であれば、やり取りの回数は大きく減ります。

<h2 id="security-disclosures">
  セキュリティ報告
</h2>

セキュリティ上の問題（修正が入る前に、インターネット上の見知らぬ相手に見られたくないもの）は、件名に**Security**と入れて`contact@intention.xyz`に送ってください。通常のメールより先に振り分けられます。プログラムの規定は[バグバウンティ](/ja/protocol/security/bug-bounty)のページにあります。提出前にそのページを読んでください。文書化された手順に従うことが、報奨金の対象となる条件です。

<h2 id="summary">
  まとめ
</h2>

| 内容                | 記載するもの                                                               |
| ----------------- | -------------------------------------------------------------------- |
| エンドポイントの挙動が想定と異なる | リクエストボディ、レスポンスボディ、ヘッダー、呼び出したUTC時刻                                    |
| プロトコル文書の記述が曖昧     | どのページから読み始めたか、何について考えようとしていたか                                        |
| 商用連携              | 何を作っているか、送り主が何者か、Intention Labsに何を求めるか                               |
| セキュリティ報告          | 件名に**Security**と入れ、[バグバウンティ](/ja/protocol/security/bug-bounty)の手順に従う |

すべての宛先は`contact@intention.xyz`です。最初のメッセージが明確であれば、やり取りの回数は大きく減ります。