> ## 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](/ko/protocol/architecture/kernel) 페이지는 실행을, [IntentionBFT](/ko/protocol/architecture/intention-bft) 페이지는 합의를, [브릿지](/ko/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`로 보내십시오. 그래야 일반 메일보다 앞서 처리됩니다. 프로그램 규정은 [버그 바운티](/ko/protocol/security/bug-bounty) 페이지에 있습니다. 제출하기 전에 그 페이지를 읽으십시오. 문서화된 절차를 따르는 것이 바운티 자격을 얻는 방법입니다.

<h2 id="summary">
  요약
</h2>

| 주제                 | 포함할 내용                                                                   |
| ------------------ | ------------------------------------------------------------------------ |
| 엔드포인트가 예상과 다르게 동작함 | 요청 본문, 응답 본문, 헤더, 호출 시각(UTC)                                             |
| 프로토콜 문서가 모호함       | 어느 페이지에서 출발했는지, 무엇을 따져 보려 했는지                                            |
| 상업적 통합             | 무엇을 만들고 있는지, 누구인지, Intention Labs에서 무엇이 필요한지                             |
| 보안 제보              | 제목에 **Security**를 넣고 [버그 바운티](/ko/protocol/security/bug-bounty) 절차를 따를 것 |

모든 문의는 `contact@intention.xyz`로 갑니다. 첫 메시지가 명확할수록 오가는 횟수가 크게 줄어듭니다.