Octri: API-documentatie genereren, SDK's en MCP

Met Octri kun je API-documentatie genereren en die koppelen aan SDK's, MCP-tools en monitoring. Dezelfde specificatie vormt de basis voor de informatie en software die je aan gebruikers van je API levert.

Wat doet Octri, eenvoudig uitgelegd?

Een API-specificatie beschrijft welke aanvragen een dienst begrijpt en welke antwoorden terugkomen. Octri maakt daar een leesbare website, installeerbare clientbibliotheken en gereedschap voor AI-assistenten van. Monitoring helpt vervolgens zien wat er bij echte integraties misgaat.

Dit past bij SaaS-bedrijven en teams die een API aanbieden aan meerdere soorten ontwikkelaars. Je hebt nog steeds een werkende API nodig en moet gegenereerde uitleg controleren. De vier onderdelen kunnen afzonderlijk worden gebruikt.

Van specificatie naar een gecontroleerde publicatie

API Studio toont endpoints, parameters, geneste schema's en voorbeelden. Je kunt de tekst op de pagina aanpassen en eigen MDX-handleidingen toevoegen voor bijvoorbeeld authenticatie of de volgorde van een integratie.

Upload eerst de specificatie of koppel het GitHub-repository. Controleer namen, authenticatie en invoer- en uitvoermodellen. Genereer de pagina's en vergelijk de uitleg met het gedrag van je dienst. Test daarna een succesvolle aanvraag én een foutgeval voordat je publiceren en eventuele SDK-builds instelt.

De console verstuurt aanvragen vanuit de browser van de lezer; je CORS-beleid blijft dus bepalend. Een wijziging via GitHub kan een nieuwe build starten. Volgens de officiële werkwijze bekijk je het concept en de verschillen voordat nieuwe SDK-versies naar registries gaan.

Wat kun je gratis doen?

De officiële maandprijzen zijn op 6 oktober 2026 gecontroleerd. Het gaat om Amerikaanse dollars, exclusief belasting bij betaalde abonnementen:

• Free: één project, één SDK-taal, 50 endpoints, 100 MB monitoring per maand en eenmalig 100 AI-credits.
• Starter: 49 USD per maand, twee talen.
• Growth: 99 USD per maand, vier talen, versiebeheer en eigen code of componenten.
• Business: 249 USD per maand, alle tien talen en white-label.
• Enterprise: offerte; de generator en documentatierenderer kunnen in eigen infrastructuur draaien.

Een gegenereerde endpointbeschrijving of een antwoord van Ask-the-docs gebruikt één credit. Handmatig bewerken, SDK-builds en hosting vallen daarbuiten. Bekijk de officiële abonnementen voor overige quota en uitbreidingen.

Clientbibliotheken voor verschillende teams

SDK Studio ondersteunt TypeScript, Python, Go, Java, Kotlin, Ruby, PHP, Rust, Swift en Dart. Je stelt methodenamen, uitgesloten endpoints en taalspecifieke opties in en verbindt de gewenste pakketpublicatie.

Die tien talen zijn het platformaanbod, niet de inhoud van Free. Eigen SDK-code is beschikbaar vanaf Growth. Test de gegenereerde client voor je eigen authenticatie en bijzondere responsmodellen voordat je hem verspreidt.

MCP: documentatie lezen of echt iets uitvoeren

De MCP-server biedt zeven documentatietools en kan opgenomen API-endpoints als uitvoerbare tools aanbieden aan onder meer Claude en Cursor. Een project-ID is genoeg om de gepubliceerde documentatie te lezen.

Uitvoeren vraagt API-inloggegevens, die op de machine van de MCP-server blijven. Kies de omgeving, rechten en endpointuitsluitingen zorgvuldig. Een uitvoerbare tool kan dezelfde wijzigingen aanbrengen als een gewone API-aanvraag.

Monitoring en gegevensverwerking

Monitoring staat standaard uit. Na activering kunnen gegenereerde SDK's en backendpakketten logs, gegroepeerde fouten en traces leveren; beschikbaarheidscontroles en waarschuwingen helpen bij onderzoek. Octri beschrijft het afschermen van gevoelige informatie vóór verzending en bij ontvangst.

In het privacybeleid staat dat AI-functies relevante specificatietekst, vragen en bijbehorende passages aan modeldiensten doorgeven. Zoeken gebruikt ook embeddings van de documentatie. Volgens Octri worden deze gegevens niet voor modeltraining gebruikt. De verwerking is daarmee niet volledig lokaal.

Veelgestelde vragen

Kan ik gratis beginnen?

Ja, met de genoemde Free-limieten. Een eigen domein en GitHub-sync zijn inbegrepen. Zijn de AI-credits op, dan stoppen AI-generatie en antwoorden, maar blijven bestaande documentatie, SDK-builds en monitoring werken.

Welke specificaties kan ik importeren?

OpenAPI 3.0/3.1, Swagger 2.0, Postman en AsyncAPI worden ondersteund als JSON of YAML. Controleer de modellen na conversie.

Blijft mijn eigen tekst bewaard?

Octri bewaart handmatige wijzigingen per veld bij het opnieuw genereren. Niet aangepaste gegenereerde velden kunnen wel worden vernieuwd.

Officiële bronnen

• Octri-documentatie: installatie en SDK-handleidingen.
• Octri op GitHub: openbare pakketten en SDK-meldingen.
• Product- en factureringshulp: contact en probleemoplossing.