Octri: generator dokumentacji API, SDK i MCP

Octri to generator dokumentacji API połączony z tworzeniem bibliotek SDK, dostępem MCP i monitoringiem. Wspólna specyfikacja pomaga zespołowi utrzymywać materiały dla programistów razem z klientami API.

Do czego służy Octri? Proste wyjaśnienie

Specyfikacja API opisuje, jakie żądanie wysłać i jakiej odpowiedzi oczekiwać. Octri przekształca ten opis w stronę dokumentacji, biblioteki instalowane w aplikacjach i narzędzia dla asystentów AI. Monitoring uzupełnia ten proces o informacje o błędach po wdrożeniu.

To rozwiązanie dla dostawców API, zespołów SaaS i osób utrzymujących integracje w kilku językach. Nie zastępuje działającego backendu ani weryfikacji wygenerowanych objaśnień. Poszczególne moduły można wykorzystywać niezależnie.

Przygotuj pierwszą dokumentację i sprawdź wynik

API Studio tworzy strony endpointów z parametrami, zagnieżdżonymi schematami i przykładami. Treść można poprawiać bezpośrednio na stronie. Własne poradniki MDX pozwalają opisać uwierzytelnianie lub kolejność wywołań.

1. Wgraj specyfikację albo połącz repozytorium GitHub.
2. Sprawdź nazwy operacji, uwierzytelnianie oraz modele żądań i odpowiedzi.
3. Wygeneruj strony i porównaj tekst z faktycznym zachowaniem API.
4. W środowisku testowym wykonaj poprawne żądanie i przypadek błędu.
5. Skonfiguruj publikację oraz potrzebne SDK; zatwierdź wynik po przejrzeniu wersji roboczej i różnic.

Konsola wykonuje wywołania z przeglądarki czytelnika, więc musi na nie pozwalać polityka CORS API. Synchronizacja GitHub może uruchomić ponowną budowę, ale nowe wersje SDK trafiają do rejestrów po zatwierdzeniu.

Octri zachowuje również ręczne poprawki pól podczas ponownej generacji.

SDK dla dziesięciu języków

SDK Studio obsługuje TypeScript, Python, Go, Java, Kotlin, Ruby, PHP, Rust, Swift i Dart. Można ustalać nazwy metod, wykluczać wewnętrzne endpointy i wybierać ustawienia języka, a następnie publikować paczki.

Liczba aktywnych języków zależy od planu. Własny kod SDK jest dostępny od Growth. Przed udostępnieniem biblioteki sprawdź na rzeczywistej integracji szczególnie uwierzytelnianie i nietypowe modele odpowiedzi.

MCP dla asystentów pracujących z API

Serwer MCP oferuje siedem narzędzi dokumentacyjnych oraz opcjonalne narzędzia wykonujące operacje API. Klienci tacy jak Claude i Cursor mogą korzystać z opublikowanych informacji zamiast odtwarzać definicję interfejsu z pamięci modelu.

Do czytania wystarczy identyfikator projektu. Wykonywanie operacji wymaga danych uwierzytelniających, które pozostają na komputerze uruchamiającym MCP. Trzeba świadomie wybrać środowisko, zakres uprawnień i wykluczone endpointy.

Limity Free i ceny planów

Stan na 6 października 2026 r.: oficjalne ceny miesięczne w dolarach amerykańskich, bez podatków w płatnych planach, nie w złotych.

• Free: jeden projekt, jeden język SDK, 50 endpointów, 100 MB monitoringu miesięcznie i jednorazowo 100 kredytów AI.
• Starter: 49 USD miesięcznie, dwa języki.
• Growth: 99 USD miesięcznie, cztery języki, wersjonowanie i własny kod lub komponenty.
• Business: 249 USD miesięcznie, wszystkie dziesięć języków i white-label.
• Enterprise: wycena indywidualna; generator i renderer dokumentacji mogą działać na własnej infrastrukturze.

Opis jednego endpointu lub odpowiedź Ask-the-docs kosztuje jeden kredyt AI. Ręczna edycja, budowanie SDK i hosting nie korzystają z tego salda. Szczegóły zawiera oficjalny cennik.

Monitoring i dane wysyłane do dostawców

Monitoring jest domyślnie wyłączony. Może zbierać zdarzenia z wygenerowanych SDK i pakietów backendowych: logi, grupowane błędy, ślady żądań, testy dostępności i alarmy. Octri opisuje maskowanie danych wrażliwych przed wysłaniem i po odbiorze.

Zgodnie z polityką prywatności tworzenie tekstu przesyła odpowiednie fragmenty specyfikacji do dostawcy modelu. Pytania i pasujące fragmenty służą odpowiedziom, a dokumentacja jest także przetwarzana na potrzeby wyszukiwania. Firma deklaruje brak treningu modeli na tych treściach; nie oznacza to przetwarzania wyłącznie lokalnego.

Najczęstsze pytania

Jakie formaty przyjmuje Octri?

OpenAPI 3.0/3.1, Swagger 2.0, Postman i AsyncAPI w JSON lub YAML. Importowane schematy wymagają sprawdzenia.

Czy darmowy plan ma własną domenę?

Tak. W Free dostępne są własna domena i synchronizacja GitHub.

Co się dzieje po wyczerpaniu kredytów AI?

Generowanie AI i Ask-the-docs przestają działać. Opublikowana dokumentacja, budowanie SDK i monitoring pozostają dostępne. Bezpłatne kredyty nie odnawiają się co miesiąc.

Oficjalne materiały

• Dokumentacja Octri: konfiguracja i instrukcje SDK.
• Octri na GitHubie: publiczne pakiety i zgłoszenia błędów SDK.
• Pomoc produktowa i rozliczenia: kontakt oraz rozwiązywanie problemów.