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

# Développeurs

> Où trouver la référence de l’API, les guides d’intégration, les SDK, les outils de testnet et le code source pour construire sur Intention.

Tout ce qu’il faut pour construire sur Intention se trouve dans l’un des endroits ci-dessous. Cette page en est la carte.

Si vous intégrez pour la première fois, commencez par le **guide d’intégration** — il vous mène de l’installation d’un SDK jusqu’à un ordre exécuté sur le testnet. Si vous voyez déjà comment le système est structuré et qu’il ne vous manque que le détail champ par champ, allez directement à la **référence de l’API**.

<h2 id="start-here">
  Par où commencer
</h2>

<CardGroup cols={2}>
  <Card title="Guide d’intégration" icon="book-open" href="https://dev.intention.xyz/">
    Le parcours développeur complet : installation, authentification et signature, démarrage rapide REST, comptes, données de marché, ordres, flux de trading, transferts USDC et limites de débit.
  </Card>

  <Card title="Référence de l’API" icon="plug" href="https://testnet-openapi.intention.xyz/">
    La spécification REST et WebSocket complète, avec les schémas et un exécuteur de requêtes dans le navigateur.
  </Card>
</CardGroup>

<h2 id="what-the-api-covers">
  Ce que couvre l’API
</h2>

La référence est organisée selon les groupes suivants. Les décomptes correspondent aux endpoints de la spécification testnet actuelle.

| Groupe           | Ce qu’il couvre                                                                                                                            |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Markets**      | Liste des marchés perpétuels, carnets d’ordres, transactions, chandeliers, taux de financement                                             |
| **Trading**      | Ordres ouverts, exécutions, recherche par identifiant client d’ordre                                                                       |
| **Transactions** | Soumettre, soumettre par lots, simuler, encoder des transactions et attendre leur résultat ; estimation du gas                             |
| **Accounts**     | État des adresses et sous-adresses, positions, historique d’ordres, historique de transactions, transferts, paiements de financement       |
| **DEX Config**   | Définitions des contrats perpétuels et au comptant, configuration des frais, paliers de levier, liaisons d’agents                          |
| **Oracle**       | Prix certifiés pour le bloc courant                                                                                                        |
| **Dashboard**    | Valeur du compte, séries de PnL, calendrier de trading, récapitulatifs                                                                     |
| **Export**       | Export CSV de l’historique d’ordres, de l’historique de transactions et des paiements de financement                                       |
| **WebSocket**    | Canaux d’abonnement pour le carnet d’ordres, les transactions, le ticker, les chandeliers, les sous-comptes, les blocs et les transactions |

<h2 id="testnet-tools">
  Outils de testnet
</h2>

Des outils interactifs pour le développement, tous hébergés sur le site développeurs.

<CardGroup cols={2}>
  <Card title="Faucet" icon="faucet" href="https://dev.intention.xyz/tools-faucet">
    Récupérer des fonds de testnet pour un nouveau compte.
  </Card>

  <Card title="Recherche d’ordre" icon="magnifying-glass" href="https://dev.intention.xyz/tools-order-lookup">
    Inspecter le statut et l’historique de n’importe quel ordre à partir de son identifiant.
  </Card>

  <Card title="Testeur WebSocket" icon="signal-stream" href="https://dev.intention.xyz/tools-websocket">
    S’abonner aux canaux en direct et inspecter les messages bruts.
  </Card>

  <Card title="Vérificateur BCS" icon="binary" href="https://dev.intention.xyz/tools-bcs-verifier">
    Vérifier qu’une transaction sérialisée encode bien ce que vous attendez, avant de la signer.
  </Card>
</CardGroup>

<h2 id="sdks-and-source">
  SDK et code source
</h2>

<CardGroup cols={2}>
  <Card title="SDK" icon="cubes" href="https://dev.intention.xyz/installation">
    Les SDK officiels en TypeScript, Go, Python et C++ — génération de compte, signature, construction d’ordres et transferts.
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/intentionxyz">
    Le code source des SDK, du logiciel de nœud et des intégrations de référence.
  </Card>
</CardGroup>

<Note>
  La spécification publiée vise actuellement le testnet. La forme des endpoints est assez stable pour construire dessus, mais considérez comme susceptible de changer tout ce qui n’a pas encore été éprouvé sur le mainnet, jusqu’à ce que les notes de version du mainnet disent le contraire.
</Note>

<h2 id="run-a-node">
  Faire tourner un nœud
</h2>

L’exploitation d’un nœud **n’est pas ouverte**. L’ensemble des validateurs est exploité par Intention Labs et des partenaires invités, et l’entrée se fait sur approbation plutôt que par inscription — il n’y a pas de procédure publique d’adhésion, ni de binaire publié en téléchargement libre.

Si vous avez besoin d’exploiter de l’infrastructure, écrivez à `contact@intention.xyz` avec **Node operator** en objet. Voir [Faire tourner un nœud](/fr/developers/run-a-node) pour les rôles existants et ce qu’il faut inclure.

<Note>
  Le plus souvent, si vous voulez un nœud, c’est pour un accès en lecture — des requêtes fiables, l’historique, ne pas dépendre de l’indexeur d’un tiers. L’API ci-dessus et l’[indexeur](/fr/protocol/architecture/indexer) y répondent, sans rien avoir à exploiter.
</Note>

<h2 id="getting-help">
  Obtenir de l’aide
</h2>

Les questions d’intégration, les comportements inattendus d’un endpoint et les accords commerciaux passent tous par `contact@intention.xyz` — voir [Questions API et intégration](/fr/help/builder-questions) pour ce qu’il faut inclure.