Octri: generatore di documentazione API e SDK

Octri è un generatore di documentazione API e una piattaforma per gestire SDK, strumenti MCP e monitoraggio a partire dalla stessa specifica. È pensato per chi espone API e vuole mantenere coerenti le risorse offerte agli sviluppatori.

Che cosa fa Octri, in parole semplici?

La specifica API descrive quali richieste un servizio accetta e quali dati restituisce. Octri la trasforma in un sito di istruzioni, librerie client installabili e strumenti che un assistente IA può usare per leggere la documentazione o chiamare il servizio.

Serve soprattutto a team SaaS, fornitori di API e piattaforme per sviluppatori. Non sostituisce l'API funzionante né il controllo umano dei contenuti. I quattro moduli possono essere adottati separatamente.

Creare la prima documentazione e verificare le chiamate

API Studio organizza endpoint, parametri, schemi annidati ed esempi. Puoi modificare direttamente i testi e affiancare guide MDX scritte dal team per spiegare autenticazione, avvio o sequenze di operazioni.

1. Carica la specifica o collega il repository GitHub.
2. Controlla nomi delle operazioni, autenticazione e modelli di richiesta e risposta.
3. Genera le pagine e correggile confrontandole con l'implementazione.
4. Esegui una chiamata valida e un caso di errore in un ambiente di prova.
5. Configura pubblicazione, linguaggi e registri dei pacchetti; esamina bozza e differenze prima di approvare.

La console invia richieste dal browser del lettore, quindi dipende dalle regole CORS della tua API. Le modifiche sincronizzate da GitHub possono avviare una nuova generazione, ma la pubblicazione delle versioni SDK mantiene una fase di approvazione.

SDK per dieci ecosistemi

SDK Studio supporta TypeScript, Python, Go, Java, Kotlin, Ruby, PHP, Rust, Swift e Dart. Permette di configurare metodi, esclusioni di endpoint e opzioni specifiche del linguaggio, quindi distribuire i client nei rispettivi ecosistemi.

Non tutti i piani includono dieci linguaggi. Il codice SDK personalizzato è previsto da Growth in su. Prima della distribuzione, verifica soprattutto autenticazione e risposte particolari: la generazione non costituisce una garanzia di correttezza dell'integrazione.

Errori in produzione e trattamento dei dati

Il monitoraggio è disattivato inizialmente. Può ricevere eventi dagli SDK generati e dai pacchetti backend, con log, errori raggruppati, tracce, controlli di disponibilità e avvisi. Octri dichiara di oscurare informazioni sensibili sia prima dell'invio sia durante la ricezione.

La politica sulla privacy spiega separatamente i flussi IA: parti della specifica per scrivere le pagine, domande e passaggi pertinenti per Ask-the-docs, testo per gli embedding di ricerca. Secondo la politica, né Octri né i fornitori usano questi contenuti per addestrare modelli. Rimane comunque un'elaborazione che coinvolge servizi esterni.

Piano gratuito e opzioni a pagamento

Prezzi ufficiali mensili in dollari USA verificati il 6 ottobre 2026, imposte escluse per i piani a pagamento:

• Free: un progetto, un linguaggio SDK, 50 endpoint, 100 MB di monitoraggio al mese e 100 crediti IA una tantum.
• Starter: 49 USD al mese, due linguaggi.
• Growth: 99 USD al mese, quattro linguaggi, versioni e codice o componenti personalizzati.
• Business: 249 USD al mese, tutti i dieci linguaggi e white-label.
• Enterprise: preventivo; generatore e renderer della documentazione possono essere eseguiti nella propria infrastruttura.

Un testo generato per un endpoint o una risposta Ask-the-docs costa un credito. Modifiche manuali, build SDK e hosting non usano questo saldo. Il confronto ufficiale dei piani riporta quote e opzioni aggiuntive.

Collegare gli assistenti tramite MCP

Il server MCP espone sette strumenti di lettura e può aggiungere operazioni eseguibili per gli endpoint inclusi. Client come Claude e Cursor possono usare la documentazione pubblicata come contesto.

L'identificativo del progetto basta per consultare i documenti; le chiamate API richiedono credenziali, mantenute sulla macchina che esegue MCP. Seleziona ambiente, permessi ed esclusioni prima di abilitare operazioni che modificano dati.

Domande frequenti

Quali specifiche posso importare?

OpenAPI 3.0/3.1, Swagger 2.0, Postman e AsyncAPI, in JSON o YAML, sono elencati tra gli input supportati.

Il piano gratuito include un dominio personalizzato?

Sì, insieme alla sincronizzazione GitHub. Quando finiscono i crediti IA si fermano generazione e risposte automatiche, mentre documentazione pubblicata, build SDK e monitoraggio continuano.

Le modifiche manuali vengono conservate?

Octri conserva le correzioni a livello di campo durante la rigenerazione e può aggiornare i campi non modificati. Controlla comunque la bozza prima di pubblicare.

Risorse ufficiali

• Documentazione Octri: configurazione e guide per i linguaggi.
• Octri su GitHub: pacchetti pubblici e problemi degli SDK.
• Supporto prodotto e fatturazione: assistenza e risoluzione dei problemi.