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

# Domande su API e integrazioni

> Dove portare le domande di sviluppatori e integratori sulle API di Intention, sugli interni del protocollo e sulle integrazioni commerciali.

Questa pagina indirizza le domande di sviluppatori e integratori al posto giusto. Scegli la categoria che ti riguarda e segui le istruzioni che trovi lì.

<Note>
  Il riferimento completo delle API è pubblicato su [openapi.intention-testnet.xyz](https://openapi.intention-testnet.xyz) e il sito per sviluppatori su [dev.intention.xyz](https://dev.intention.xyz/). In alcuni punti la forma dei payload è ancora in movimento, quindi per tutto ciò che sembra incoerente scrivere una email è più rapido che consultare la specifica.
</Note>

<h2 id="questions-about-api-usage">
  Domande sull'uso delle API
</h2>

Se stai integrando prima della pubblicazione del riferimento, scrivi a `contact@intention.xyz` con una descrizione in una riga di quello che stai costruendo e degli endpoint che prevedi di usare. Il team integrazioni può anticiparti com'è fatta al momento l'interfaccia e segnalarti tutto ciò che con ogni probabilità cambierà prima del lancio.

Quando sei già operativo su un endpoint e questo si comporta diversamente dalle attese, scrivi a `contact@intention.xyz` allegando il corpo della richiesta, il corpo della risposta, gli header rilevanti e l'orario UTC della chiamata. I ticket che citano il payload incriminato e la risposta osservata si risolvono di solito in un solo scambio, perché il team integrazioni può rieseguirli direttamente su staging.

<h2 id="questions-about-protocol-internals">
  Domande sugli interni del protocollo
</h2>

Se stai cercando di capire perché il protocollo si comporta in un certo modo — semantica del matching, garanzie di sequenziamento, flusso delle commissioni, matematica del margine, certificazione dell'oracolo — parti dalla sezione architettura di questo sito. La pagina [IntentionKernel](/it/protocol/architecture/kernel) copre l'esecuzione; [IntentionBFT](/it/protocol/architecture/intention-bft) copre il consenso; la pagina [Bridge](/it/protocol/architecture/bridge) copre depositi e prelievi. Se dopo averle lette ti resta una domanda di natura architetturale e non operativa, scrivi a `contact@intention.xyz` inquadrando in un paragrafo che cosa stai cercando di ricostruire e da quale pagina sei partito. Il team di protocollo smista queste domande e risponde direttamente oppure commissiona un miglioramento della documentazione, così il lettore successivo non dovrà più chiedere.

<h2 id="commercial-integration">
  Integrazioni commerciali
</h2>

Partnership, quotazioni, accordi di market making e qualunque cosa implichi un rapporto commerciale vanno a `contact@intention.xyz`. Includi una descrizione in una riga di quello che stai costruendo, di chi sei e di che cosa ti serve da Intention Labs perché funzioni. Un primo messaggio chiaro riduce moltissimo gli scambi successivi.

<h2 id="security-disclosures">
  Segnalazioni di sicurezza
</h2>

I problemi di sicurezza — tutto ciò che non vorresti finisse sotto gli occhi di uno sconosciuto su internet prima che esista una correzione — vanno a `contact@intention.xyz` con **Security** nell'oggetto, così vengono instradati prima della posta ordinaria. Le regole del programma sono sulla pagina [Bug bounty](/it/protocol/security/bug-bounty). Leggila prima di inviare: seguire la procedura documentata è ciò che ti qualifica per la ricompensa.

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

| Argomento                                | Che cosa includere                                                                                    |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| Un endpoint si comporta in modo inatteso | Corpo della richiesta, corpo della risposta, header e orario UTC della chiamata                       |
| Un documento di protocollo è ambiguo     | Da quale pagina sei partito e che cosa stavi cercando di ricostruire                                  |
| Integrazione commerciale                 | Che cosa stai costruendo, chi sei e che cosa ti serve da Intention Labs                               |
| Segnalazione di sicurezza                | Metti **Security** nell'oggetto e segui il processo di [bug bounty](/it/protocol/security/bug-bounty) |

Tutto va a `contact@intention.xyz`. Un primo messaggio chiaro riduce moltissimo gli scambi successivi.