Octri: Generator Dokumentasi API dari Spesifikasi

Octri adalah generator dokumentasi API yang menghubungkan spesifikasi dengan halaman referensi, SDK klien, alat MCP dan pemantauan. Platform ini ditujukan bagi tim yang ingin menjaga materi integrasi tetap selaras dengan sumber teknisnya.

Sederhananya, Octri dipakai untuk apa?

Bayangkan spesifikasi API sebagai buku petunjuk yang menjelaskan permintaan yang diterima layanan dan data yang dikembalikan. Octri mengubahnya menjadi situs yang dibaca pengembang, pustaka yang dipasang dalam aplikasi, serta alat yang bisa digunakan asisten AI untuk mengakses API.

Tim SaaS, penyedia API dan tim kecil yang mengurus beberapa integrasi klien dapat memakainya. Anda tetap perlu API yang berfungsi dan spesifikasi yang benar. Octri tidak menggantikan implementasi layanan maupun pemeriksaan hasil generasi. Modulnya dapat digunakan secara terpisah sesuai kebutuhan.

Dari spesifikasi hingga dokumentasi yang siap ditinjau

API Studio menerima berkas spesifikasi atau repositori GitHub yang terhubung. Anda dapat membuat penjelasan endpoint, menampilkan skema bertingkat dan menyertakan contoh permintaan. Halaman bisa disunting langsung; panduan MDX dapat menjelaskan autentikasi dan langkah integrasi yang lebih panjang.

1. Impor spesifikasi lalu periksa nama operasi, autentikasi serta skema permintaan dan respons.
2. Buat dokumentasi dan cocokkan penjelasannya dengan perilaku API yang sebenarnya.
3. Uji endpoint di lingkungan pengujian melalui konsol permintaan interaktif, termasuk respons kesalahan. Permintaan dikirim dari browser sehingga pengaturan CORS API perlu diperiksa.
4. Atur publikasi, bahasa SDK dan koneksi ke registri paket bila diperlukan.
5. Tinjau draf dan perbedaannya sebelum menyetujui penerbitan.

Sinkronisasi GitHub tersedia di semua paket. Perubahan spesifikasi dapat memicu pembangunan ulang, tetapi alur resmi tetap meminta persetujuan sebelum versi SDK baru dikirim ke registri.

SDK untuk sepuluh bahasa pemrograman

SDK Studio mendukung TypeScript, Python, Go, Java, Kotlin, Ruby, PHP, Rust, Swift dan Dart. Nama metode, pengecualian endpoint dan pengaturan bahasa dapat disesuaikan. Integrasi registri membantu mendistribusikan pustaka melalui ekosistem paket yang digunakan pelanggan.

Dukungan sepuluh bahasa berlaku untuk platform secara keseluruhan. Jumlah bahasa yang dapat diaktifkan bergantung pada paket. Kode SDK khusus tersedia mulai Growth. Sebelum merilisnya, uji autentikasi dan skema respons yang tidak lazim terhadap API Anda.

Menghubungkan asisten AI melalui MCP

Server MCP Octri memiliki tujuh alat dokumentasi dan dapat menyediakan endpoint yang disertakan sebagai alat yang bisa dieksekusi. Claude, Cursor dan klien MCP lain dapat membaca referensi yang telah diterbitkan untuk membantu pekerjaan integrasi.

Akses dokumentasi menggunakan ID proyek. Eksekusi API memerlukan kredensial yang sesuai; kredensial tetap berada di mesin yang menjalankan server. Tentukan lingkungan tujuan, batasi izin dan kecualikan operasi yang tidak seharusnya dijalankan agen sebelum mengaktifkan pemanggilan API.

Batas gratis dan pilihan berlangganan

Harga bulanan resmi berikut diperiksa pada 6 Oktober 2026. Nilainya dalam dolar AS, belum termasuk pajak, dan bukan harga lokal dalam rupiah.

• Free: satu proyek, satu bahasa SDK, 50 endpoint, 100 MB pemantauan per bulan dan 100 kredit AI yang diberikan sekali.
• Starter: 49 dolar AS per bulan dengan dua bahasa SDK.
• Growth: 99 dolar AS per bulan dengan empat bahasa, pengelolaan versi serta kode/komponen khusus.
• Business: 249 dolar AS per bulan dengan semua sepuluh bahasa dan opsi white label.
• Enterprise: penawaran khusus; generator dan perender dokumentasi dapat dijalankan di infrastruktur sendiri.

Generasi satu endpoint atau satu jawaban Ask-the-docs menghabiskan satu kredit AI. Penyuntingan manual, pembangunan SDK dan hosting tidak memakai kredit tersebut. Jika kredit habis, generasi AI dan jawaban berhenti, sedangkan dokumentasi yang sudah terbit, pembangunan SDK dan pemantauan tetap berjalan. Lihat perbandingan paket Octri untuk kuota dan tambahan terbaru.

Memantau kegagalan dan memahami pengolahan data

Pemantauan tidak aktif secara bawaan. Ketika digunakan dengan SDK hasil generasi atau paket backend yang didukung, fitur ini mencakup log, pengelompokan masalah, trace, pemeriksaan ketersediaan dan peringatan. Octri menjelaskan penyamaran data sensitif di sisi klien dan saat data diterima.

Menurut kebijakan privasi, teks spesifikasi yang relevan dikirim ke penyedia model untuk generasi. Pertanyaan dan cuplikan yang cocok dikirim untuk Ask-the-docs; teks dokumentasi juga diproses untuk embedding pencarian. Octri menyatakan bahwa mereka dan penyedianya tidak melatih model menggunakan konten tersebut. Proses ini menggunakan layanan yang dihosting, bukan sepenuhnya berjalan secara lokal.

Pertanyaan umum

Apakah Octri bisa dipakai gratis?

Bisa, selama penggunaan berada dalam batas Free. Paket ini juga mencakup domain khusus dan sinkronisasi GitHub. Seratus kredit AI diberikan sekali, bukan diperbarui setiap bulan.

Spesifikasi apa yang dapat diimpor?

Daftar resmi mencakup OpenAPI 3.0/3.1, Swagger 2.0, Postman dan AsyncAPI dalam JSON atau YAML. Periksa skema dan contoh setelah impor, terutama jika spesifikasi sebelumnya dikonversi dari format lain.

Apakah pembaruan menghapus suntingan manual?

Octri menyatakan bahwa bidang yang disunting manual dipertahankan, sementara bidang hasil generasi yang belum diubah dapat diperbarui. Tetap tinjau draf dan perbedaannya saat spesifikasi berubah.

Sumber resmi untuk pengembang

• Dokumentasi Octri: penyiapan proyek, panduan SDK dan konfigurasi MCP.
• Octri di GitHub: paket publik dan pelaporan masalah SDK.
• Dukungan produk dan penagihan: jalur bantuan resmi.