Octri: Tạo tài liệu API từ đặc tả, kết nối SDK và MCP

Octri là nền tảng tạo tài liệu API từ đặc tả, đồng thời cung cấp SDK, kết nối MCP và giám sát tích hợp. Công cụ phù hợp khi nhóm muốn duy trì tài liệu và thư viện máy khách dựa trên cùng một nguồn thông tin.

Hiểu đơn giản: Octri dùng để làm gì?

Hãy coi đặc tả API là bản hướng dẫn kỹ thuật về yêu cầu mà dịch vụ chấp nhận và dữ liệu trả về. Octri biến bản hướng dẫn đó thành website để lập trình viên đọc, thư viện để cài vào ứng dụng và công cụ để trợ lý AI sử dụng API.

Nhóm SaaS, nhà cung cấp API và đội phát triển nhỏ phải hỗ trợ nhiều tích hợp có thể dùng Octri để giảm công việc lặp lại. Bạn vẫn cần API hoạt động và đặc tả đúng; công cụ không thay thế phần triển khai dịch vụ hay việc kiểm tra nội dung sinh ra. Có thể dùng từng mô-đun mà không bật toàn bộ nền tảng.

Quy trình từ tệp đặc tả đến tài liệu đã kiểm tra

API Studio nhận tệp đặc tả hoặc kết nối kho GitHub. Công cụ tạo mô tả cho endpoint, hiển thị schema lồng nhau và đặt ví dụ yêu cầu cạnh phần tham chiếu. Bạn có thể sửa trang trực tiếp và bổ sung hướng dẫn MDX về xác thực hoặc quy trình tích hợp.

1. Nhập đặc tả, kiểm tra tên thao tác, cơ chế xác thực và schema yêu cầu/phản hồi.
2. Tạo bản tài liệu rồi đối chiếu nội dung với hành vi thực tế của API.
3. Dùng bảng gửi yêu cầu tương tác để thử một endpoint trong môi trường kiểm thử, gồm cả tình huống lỗi. Yêu cầu đi từ trình duyệt nên cấu hình CORS của API có ảnh hưởng.
4. Thiết lập xuất bản, chọn ngôn ngữ SDK và kết nối kho gói nếu cần.
5. Xem bản nháp và phần khác biệt, sau đó phê duyệt việc phát hành.

Đồng bộ GitHub có trên mọi gói. Thay đổi đặc tả có thể kích hoạt xây dựng lại, nhưng quy trình chính thức vẫn có bước phê duyệt trước khi SDK phiên bản mới được đưa lên kho gói.

Octri cũng cho biết các trường bạn sửa thủ công được giữ lại khi cập nhật, còn trường sinh tự động chưa chỉnh sửa có thể được làm mới.

Gói miễn phí có gì, khi nào cần nâng cấp?

Giá tháng chính thức được kiểm tra ngày 6 tháng 10 năm 2026, tính bằng USD và chưa bao gồm thuế; đây không phải mức giá quy đổi sang đồng Việt Nam.

• Free: một dự án, một ngôn ngữ SDK, 50 endpoint, 100 MB dữ liệu giám sát mỗi tháng và 100 tín dụng AI cấp một lần.
• Starter: 49 USD/tháng, hai ngôn ngữ SDK.
• Growth: 99 USD/tháng, bốn ngôn ngữ, quản lý phiên bản và mã/thành phần tùy chỉnh.
• Business: 249 USD/tháng, đủ mười ngôn ngữ và tùy chọn nhãn trắng.
• Enterprise: báo giá riêng; có thể chạy bộ sinh và bộ hiển thị tài liệu trên hạ tầng của doanh nghiệp.

Mỗi lần sinh nội dung cho một endpoint hoặc trả lời một câu hỏi Ask-the-docs dùng một tín dụng AI. Sửa thủ công, xây dựng SDK và lưu trữ website không dùng loại tín dụng này. Xem bảng so sánh gói Octri để biết đầy đủ hạn mức và tiện ích bổ sung.

Tạo SDK cho các hệ sinh thái của khách hàng

SDK Studio hỗ trợ TypeScript, Python, Go, Java, Kotlin, Ruby, PHP, Rust, Swift và Dart. Bạn có thể đổi tên phương thức, loại trừ endpoint và điều chỉnh thiết lập theo ngôn ngữ. Kết nối kho gói giúp đưa thư viện tới nơi người dùng thường cài đặt phần mềm.

Mười ngôn ngữ là phạm vi hỗ trợ của nền tảng; số ngôn ngữ được kích hoạt phụ thuộc gói. Tính năng thêm mã SDK tùy chỉnh bắt đầu từ Growth. Trước khi phát hành, hãy kiểm tra xác thực và những schema phản hồi đặc biệt với API của bạn.

Kết nối trợ lý AI bằng MCP

Máy chủ MCP của Octri cung cấp bảy công cụ tài liệu và có thể đưa các endpoint được chọn thành công cụ thực thi. Claude, Cursor và ứng dụng tương thích MCP có thể đọc nội dung tham chiếu đã xuất bản để hỗ trợ tích hợp.

Truy cập tài liệu dùng ID dự án. Thực thi API cần thông tin xác thực phù hợp, được giữ trên máy chạy máy chủ. Hãy chọn môi trường, giới hạn quyền và loại trừ các thao tác không nên cho trợ lý thực hiện trước khi bật khả năng gọi API.

Theo dõi lỗi và hiểu dữ liệu được xử lý ở đâu

Giám sát mặc định tắt. Khi dùng với SDK được sinh hoặc các gói backend được hỗ trợ, bạn có thể xem log, nhóm lỗi, trace, kiểm tra thời gian hoạt động và cảnh báo. Octri mô tả việc che dữ liệu nhạy cảm ở phía máy khách và khi tiếp nhận dữ liệu.

Theo chính sách quyền riêng tư, phần đặc tả cần thiết được gửi tới nhà cung cấp mô hình để tạo nội dung. Ask-the-docs gửi câu hỏi cùng đoạn tài liệu phù hợp; văn bản tài liệu cũng được xử lý để tạo embedding tìm kiếm. Octri cho biết họ và các nhà cung cấp không dùng nội dung này để huấn luyện mô hình. Vì vậy, không nên hiểu đây là quy trình chạy hoàn toàn trên máy cá nhân.

Câu hỏi thường gặp

Gói miễn phí có dùng tên miền riêng được không?

Có. Octri liệt kê tên miền riêng và đồng bộ GitHub trong gói Free. Bạn vẫn cần tuân theo giới hạn dự án, endpoint, ngôn ngữ và tín dụng của gói.

Octri nhận những định dạng đặc tả nào?

Danh sách chính thức gồm OpenAPI 3.0/3.1, Swagger 2.0, Postman và AsyncAPI ở định dạng JSON hoặc YAML. Sau khi nhập, hãy kiểm tra schema và ví dụ thay vì mặc định rằng quá trình chuyển đổi luôn đầy đủ.

Hết tín dụng AI thì tài liệu có bị tắt không?

Không. Việc sinh nội dung bằng AI và trả lời Ask-the-docs dừng lại, còn tài liệu đã xuất bản, xây dựng SDK và giám sát tiếp tục hoạt động. Một trăm tín dụng Free được cấp một lần, không tự gia hạn mỗi tháng.

Tài nguyên chính thức cho lập trình viên

• Tài liệu Octri: thiết lập dự án, hướng dẫn SDK và cấu hình MCP.
• Octri trên GitHub: các gói công khai và báo lỗi SDK.
• Hỗ trợ sản phẩm và thanh toán: kênh trợ giúp chính thức.