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

# Questions API et intégration

> Où adresser les questions des développeurs et des intégrateurs sur l’API Intention, les mécanismes internes du protocole et les intégrations commerciales.

Cette page oriente les questions des développeurs et des intégrateurs vers le bon endroit. Choisissez la catégorie qui correspond et suivez les instructions qu’elle donne.

<Note>
  La référence complète de l’API est publiée sur [openapi.intention-testnet.xyz](https://openapi.intention-testnet.xyz) et le site développeurs sur [dev.intention.xyz](https://dev.intention.xyz/). La forme de certains payloads bouge encore ; pour tout ce qui paraît incohérent, l’e-mail va plus vite que la spécification.
</Note>

<h2 id="questions-about-api-usage">
  Questions sur l’usage de l’API
</h2>

Si vous intégrez avant la publication de la référence, écrivez à `contact@intention.xyz` avec une description en une ligne de ce que vous construisez et des endpoints dont vous pensez avoir besoin. L’équipe intégration peut vous communiquer l’état de travail de la surface et signaler ce qui risque de changer d’ici au lancement.

Une fois que vous appelez un endpoint et qu’il se comporte autrement que prévu, écrivez à `contact@intention.xyz` en joignant le corps de la requête, le corps de la réponse, les en-têtes pertinents et l’heure UTC de l’appel. Les tickets qui citent le payload fautif et la réponse observée se règlent en général en un seul aller-retour, parce que l’équipe intégration peut les rejouer directement contre la préproduction.

<h2 id="questions-about-protocol-internals">
  Questions sur les mécanismes internes du protocole
</h2>

Si vous cherchez à comprendre pourquoi le protocole se comporte d’une certaine façon — sémantique d’appariement, garanties de séquencement, circulation des frais, calcul de marge, certification de l’oracle — commencez par la section architecture de ce site. La page [IntentionKernel](/fr/protocol/architecture/kernel) couvre l’exécution ; [IntentionBFT](/fr/protocol/architecture/intention-bft) couvre le consensus ; la page [Bridge](/fr/protocol/architecture/bridge) couvre les dépôts et les retraits. Si, après les avoir lues, il vous reste une question de nature architecturale plutôt qu’opérationnelle, écrivez à `contact@intention.xyz` en cadrant en un paragraphe ce que vous cherchez à comprendre et la page dont vous êtes parti. L’équipe protocole trie ces questions et soit y répond directement, soit commande une amélioration de la documentation pour que le lecteur suivant n’ait pas à poser la question.

<h2 id="commercial-integration">
  Intégration commerciale
</h2>

Les partenariats, les cotations, les accords de tenue de marché et tout ce qui suppose une relation d’affaires vont à `contact@intention.xyz`. Indiquez en une ligne ce que vous construisez, qui vous êtes et ce dont vous avez besoin de la part d’Intention Labs pour que cela fonctionne. Un premier message clair réduit considérablement les allers-retours.

<h2 id="security-disclosures">
  Divulgations de sécurité
</h2>

Les problèmes de sécurité — tout ce que vous ne voudriez pas voir entre les mains d’un inconnu avant qu’un correctif existe — vont à `contact@intention.xyz` avec **Security** en objet, afin d’être traités avant le courrier ordinaire. Les règles du programme sont sur la page [Bug bounty](/fr/protocol/security/bug-bounty). Lisez-la avant de soumettre : c’est en suivant la procédure documentée que vous devenez éligible à la prime.

<h2 id="summary">
  Récapitulatif
</h2>

| Sujet                                       | Ce qu’il faut joindre                                                                                 |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| Un endpoint se comporte de façon inattendue | Corps de la requête, corps de la réponse, en-têtes et heure UTC de l’appel                            |
| Un document sur le protocole est ambigu     | La page dont vous êtes parti et ce que vous cherchiez à comprendre                                    |
| Intégration commerciale                     | Ce que vous construisez, qui vous êtes et ce dont vous avez besoin d’Intention Labs                   |
| Divulgation de sécurité                     | Mettez **Security** en objet et suivez la procédure du [bug bounty](/fr/protocol/security/bug-bounty) |

Tout passe par `contact@intention.xyz`. Un premier message clair réduit considérablement les allers-retours.