Scalar

Scalar là một nền tảng trải nghiệm nhà phát triển mã nguồn mở hiện đại được thiết kế để lập tài liệu, kiểm thử và khám phá API. Nó cung cấp một bộ công cụ toàn diện giúp biến các tệp OpenAPI/Swagger tiêu chuẩn thành tài liệu API tương tác đẳng cấp thế giới. Nền tảng này được tin cậy bởi một loạt người dùng, từ các công ty khởi nghiệp đến các công ty trong danh sách Fortune 500, vì sức mạnh, tính linh hoạt và cách tiếp cận lấy nhà phát triển làm trung tâm.

Về cốt lõi, Scalar tạo ra các tài liệu tham khảo API đẹp mắt và có chức năng cao. Các tài liệu này không tĩnh; chúng bao gồm một sân chơi tương tác cho phép các nhà phát triển và người dùng kiểm thử các điểm cuối API trực tiếp trong trình duyệt. Sự tích hợp liền mạch giữa tài liệu và kiểm thử này giúp giảm đáng kể thời gian làm quen và đơn giản hóa quy trình làm việc của nhà phát triển. Nền tảng này cũng bao gồm một Trình chỉnh sửa Swagger mạnh mẽ, cho phép người dùng xem trước, chỉnh sửa và quản lý các đặc tả OpenAPI của họ một cách dễ dàng.

Cách sử dụng Scalar

Bắt đầu với Scalar rất đơn giản. Các nhà phát triển có thể bắt đầu bằng cách nhập một tệp OpenAPI/Swagger hiện có (hỗ trợ các phiên bản 3.1, 3.0 và 2.0) hoặc tạo một tệp mới từ đầu bằng Trình chỉnh sửa Swagger tích hợp. Sau khi đặc tả được tải, Scalar sẽ tự động tạo tài liệu tương tác.

Để tích hợp vào các dự án, Scalar cung cấp các gói cho nhiều framework như .NET, Fastify, Next.js, Laravel, Express, v.v. Một lệnh đơn giản, chẳng hạn như dotnet add package Scalar.AspNetCore, thường là tất cả những gì cần thiết. Từ đó, các nhà phát triển có thể thêm một vài dòng mã vào ứng dụng của mình để phục vụ tài liệu tham khảo API của Scalar. Nền tảng này cũng cung cấp một Client API độc lập, ưu tiên ngoại tuyến, có sẵn cho Web, macOS, Linux và Windows, có thể được sử dụng độc lập hoặc kết hợp với tài liệu để kiểm thử API mạnh mẽ.

Tính năng chính của Scalar

• Tài liệu API tương tác: Tự động tạo tài liệu API đẹp mắt, thân thiện với người dùng từ các tệp OpenAPI/Swagger với sân chơi kiểm thử tích hợp.
• Client API tích hợp: Một client API REST mạnh mẽ, ưu tiên ngoại tuyến, có sẵn trên tất cả các nền tảng máy tính để bàn chính để kiểm thử và gỡ lỗi API toàn diện.
• Trình chỉnh sửa Swagger: Một công cụ mã nguồn mở miễn phí để xem trước, chỉnh sửa và quản lý các tệp Swagger/OAS trực tiếp trong nền tảng.
• Tùy chỉnh rộng rãi: Cung cấp khả năng xây dựng thương hiệu đầy đủ với các chủ đề, màu sắc, kiểu chữ tùy chỉnh và khả năng thêm CSS/JavaScript tùy chỉnh, ngay cả trên gói miễn phí.
• Tích hợp với các Framework: Cung cấp các gói dễ sử dụng cho nhiều loại framework backend phổ biến, bao gồm .NET, Nitro, FastAPI, Hono, NestJS, v.v.
• Đồng bộ hóa Git + Markdown: Cho phép tài liệu tồn tại song song với mã nguồn, hỗ trợ các tài liệu được viết bằng Markdown và liên kết với các tệp OpenAPI.
• Lõi mã nguồn mở: Được xây dựng bởi và cho cộng đồng, đảm bảo tính minh bạch, cải tiến liên tục và không bị khóa nhà cung cấp.
• Tạo mẫu mã: Tự động tạo các mẫu mã bằng nhiều ngôn ngữ lập trình phổ biến để giúp người dùng sử dụng API.

Các trường hợp sử dụng Scalar

Scalar lý tưởng cho bất kỳ cá nhân hoặc nhóm nào xây dựng, duy trì hoặc sử dụng API. Một trường hợp sử dụng chính là cho các công ty muốn cung cấp trải nghiệm nhà phát triển đặc biệt cho các API công khai hoặc nội bộ của họ. Ví dụ, các công ty như Supabase, Maersk và Tailscale sử dụng Scalar để cung cấp năng lượng cho tài liệu API của họ. Nó cũng hoàn hảo cho các nhà phát triển cá nhân cần một cách nhanh chóng và dễ dàng để hình dung và kiểm thử một API mà họ đang làm việc. Các nhóm có thể sử dụng các tính năng cộng tác trong gói Pro để đồng bộ hóa không gian làm việc kiểm thử API và đảm bảo tính nhất quán trong suốt vòng đời phát triển.

Ưu điểm của Scalar

Ưu điểm chính của Scalar là sự tích hợp liền mạch giữa tài liệu và kiểm thử vào một nền tảng duy nhất, gắn kết. Không giống như các công cụ khác tách biệt các chức năng này, Scalar cho phép người dùng đọc về một điểm cuối và kiểm thử nó ngay lập tức mà không cần rời khỏi trang. Bản chất mã nguồn mở và cam kết với đặc tả OpenAPI của nó giúp tránh bị khóa nhà cung cấp. Mức độ tùy chỉnh cao cho phép các công ty duy trì tính nhất quán của thương hiệu. Hơn nữa, client API ưu tiên ngoại tuyến của nó là một lợi ích đáng kể cho các nhà phát triển cần làm việc mà không có kết nối internet liên tục. Gói miễn phí hào phóng giúp mọi người đều có thể tiếp cận, trong khi gói Pro giá cả phải chăng cung cấp các tính năng mạnh mẽ cho các nhóm chuyên nghiệp.

Giá cả và gói dịch vụ

Scalar cung cấp một mô hình định giá freemium linh hoạt:

• Gói miễn phí: Bao gồm 1 người dùng, không gian làm việc không giới hạn, tên miền phụ miễn phí (trên apidocumentation.com), tài liệu tham khảo API, tạo kiểu đầy đủ với các chủ đề và CSS/JS tùy chỉnh, và Client API Scalar tích hợp.
• Gói Pro ($12 mỗi người dùng/tháng): Bao gồm mọi thứ trong gói Miễn phí, cộng với tên miền tùy chỉnh, đồng bộ hóa với GitHub, hướng dẫn & phiên bản, tìm kiếm nâng cao (được cung cấp bởi TypeSense) và hỗ trợ ưu tiên.
• Gói Doanh nghiệp (Giá tùy chỉnh): Bao gồm tất cả các tính năng của Pro, cộng với SSO/SAML, kiểm tra tài liệu hàng tháng, không gian làm việc đã được xác minh và một kênh Slack chuyên dụng để hỗ trợ.