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

# Preguntas de API e integración

> Dónde llevar las preguntas de desarrolladores e integradores sobre la API de Intention, el funcionamiento interno del protocolo y las integraciones comerciales.

Esta página encamina las preguntas de desarrolladores e integradores al sitio adecuado. Elige la categoría que encaje y sigue las instrucciones que encontrarás allí.

<Note>
  La referencia completa de la API está publicada en [openapi.intention-testnet.xyz](https://openapi.intention-testnet.xyz) y el sitio para desarrolladores en [dev.intention.xyz](https://dev.intention.xyz/). La forma de algunos payloads todavía se mueve, así que para cualquier cosa que parezca inconsistente el correo es más rápido que la especificación.
</Note>

<h2 id="questions-about-api-usage">
  Preguntas sobre el uso de la API
</h2>

Si estás integrando por delante de la referencia publicada, escribe a `contact@intention.xyz` con una descripción de una línea de lo que estás construyendo y los endpoints que crees que vas a necesitar. El equipo de integración puede compartir la forma provisional de la superficie y señalar lo que probablemente cambie antes del lanzamiento.

Cuando ya estés llamando a un endpoint y se comporte de forma distinta a la esperada, escribe a `contact@intention.xyz` e incluye el cuerpo de la solicitud, el cuerpo de la respuesta, las cabeceras relevantes y la hora UTC de la llamada. Los tickets que citan el payload problemático y la respuesta observada suelen resolverse en un solo intercambio, porque el equipo de integración puede reproducirlos directamente contra staging.

<h2 id="questions-about-protocol-internals">
  Preguntas sobre el funcionamiento interno del protocolo
</h2>

Si intentas entender por qué el protocolo se comporta de determinada manera (semántica de casación, garantías de secuenciación, flujo de comisiones, matemática del margen, certificación del oráculo), empieza por la sección de arquitectura de este sitio. La página de [IntentionKernel](/es/protocol/architecture/kernel) cubre la ejecución; [IntentionBFT](/es/protocol/architecture/intention-bft) cubre el consenso; la página del [Puente](/es/protocol/architecture/bridge) cubre depósitos y retiros. Si al terminar de leerlas te queda una duda arquitectónica más que operativa, escribe a `contact@intention.xyz` con un párrafo que enmarque lo que intentas razonar y de qué página partiste. El equipo de protocolo clasifica esas preguntas y o bien responde directamente, o bien encarga una mejora de la documentación para que el siguiente lector no tenga que preguntar.

<h2 id="commercial-integration">
  Integración comercial
</h2>

Alianzas, listados, acuerdos de market making y cualquier cosa que implique una relación de negocio van a `contact@intention.xyz`. Incluye una descripción de una línea de lo que estás construyendo, quién eres y qué necesitas de Intention Labs para que funcione. Un primer mensaje claro reduce mucho las idas y venidas.

<h2 id="security-disclosures">
  Divulgación de fallos de seguridad
</h2>

Los problemas de seguridad (cualquier cosa que no querrías que viera un desconocido de internet antes de que exista una corrección) van a `contact@intention.xyz` con **Security** en el asunto, para que se encaminen por delante del correo ordinario. Las reglas del programa están en la página de [Bug bounty](/es/protocol/security/bug-bounty). Léela antes de enviar nada; seguir el procedimiento documentado es lo que te hace elegible para la recompensa.

<h2 id="summary">
  Resumen
</h2>

| Tema                                        | Qué incluir                                                                                        |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| Un endpoint se comporta de forma inesperada | Cuerpo de la solicitud, cuerpo de la respuesta, cabeceras y la hora UTC de la llamada              |
| Un documento del protocolo es ambiguo       | De qué página partiste y qué intentabas razonar                                                    |
| Integración comercial                       | Qué estás construyendo, quién eres y qué necesitas de Intention Labs                               |
| Divulgación de seguridad                    | Pon **Security** en el asunto y sigue el proceso de [bug bounty](/es/protocol/security/bug-bounty) |

Todo va a `contact@intention.xyz`. Un primer mensaje claro reduce mucho las idas y venidas.