Dự án API Blueprint , từng là một giải pháp thay thế đầy hứa hẹn cho OpenAPI / Swagger trong việc tài liệu hóa API , đã chính thức được cộng đồng phát triển tuyên bố là đã chết. Ngôn ngữ mô tả API cấp cao này nhằm mục đích làm cho việc thiết kế API trở nên dễ tiếp cận hơn thông qua cú pháp dựa trên Markdown hiện không còn được duy trì tích cực.
Thông số kỹ thuật chính của API Blueprint:
- Loại phương tiện:
text/vnd.apiblueprint - Phần mở rộng tệp:
.apib - Giấy phép: MIT
- Cú pháp: Dựa trên Markdown
- Hỗ trợ GitHub: Hỗ trợ đầy đủ tô sáng cú pháp
Việc thâu tóm của Oracle giết chết sự phát triển cộng đồng
Sự sụp đổ của dự án có thể truy nguyên từ việc Oracle thâu tóm công ty đứng sau API Blueprint . Sau vụ mua lại, tất cả các kho lưu trữ công khai đã được lưu trữ bởi chủ sở hữu, khiến cộng đồng mã nguồn mở không có sự hỗ trợ chính thức hoặc hướng phát triển. Kho lưu trữ GitHub hiện mang trạng thái đã được lưu trữ bởi chủ sở hữu, báo hiệu sự kết thúc của việc phát triển tích cực.
Mô hình thâu tóm doanh nghiệp này đã trở nên quen thuộc trong thế giới công nghệ, nơi các dự án mã nguồn mở đầy hứa hẹn bị hấp thụ vào các công ty lớn hơn chỉ để bị ngừng hoạt động một cách lặng lẽ khi chúng không phù hợp với các ưu tiên của doanh nghiệp.
Cộng đồng đặt câu hỏi về các nỗ lực hồi sinh dự án
Mặc dù bị từ bỏ chính thức, một số nhà phát triển vẫn đang khám phá API Blueprint và đăng bài về nó trên các nền tảng xã hội, dẫn đến sự nhầm lẫn về tình trạng hiện tại của dự án. Các thành viên cộng đồng đã nhanh chóng chỉ ra rằng những bài đăng này đại diện cho thông tin lỗi thời hơn là các cập nhật dự án thực sự.
Bối rối tại sao điều này được đăng bây giờ - dự án dường như đã chết từ nhiều năm trước.
Sự ngắt kết nối này làm nổi bật cách các dự án bị bỏ rơi có thể tiếp tục lưu hành trong các cộng đồng phát triển lâu sau khi tính hữu ích thực tế của chúng đã kết thúc.
Những lợi thế kỹ thuật bị mất vào tay các giải pháp thay thế tốt hơn
Điểm mạnh cốt lõi của API Blueprint nằm ở cách tiếp cận dựa trên Markdown , giúp các đặc tả dễ đọc hơn nhiều trong các trình soạn thảo văn bản thuần túy so với định dạng YAML của OpenAPI . Ngôn ngữ này cũng hỗ trợ kiểu dáng tài liệu phong phú và được GitHub chính thức công nhận với tính năng làm nổi bật cú pháp cho các tệp .apib.
Tuy nhiên, dự án gặp phải những hạn chế trong việc xử lý các tình huống API phức tạp, chẳng hạn như chỉ định nhiều loại phản hồi với các tiêu đề nội dung khác nhau. Trong khi đó, OpenAPI đã phát triển đáng kể, thêm các tính năng mạnh mẽ như tính đa hình thông qua các cấu trúc oneOf, mặc dù một số nhà phát triển cho rằng điều này làm cho nó trở nên quá phức tạp.
TypeSpec của Microsoft đã nổi lên như một giải pháp thay thế hiện đại, được phát triển tích cực và sử dụng cho các dịch vụ Azure . Không giống như API Blueprint bị bỏ rơi, TypeSpec được hưởng sự hỗ trợ của doanh nghiệp và tiếp tục phát triển với việc sử dụng doanh nghiệp trong thế giới thực.
Các lựa chọn thay thế hiện đại cho API Blueprint:
- OpenAPI/Swagger: Tiêu chuẩn ngành, dựa trên YAML, có bộ công cụ phong phú
- Microsoft TypeSpec: Được phát triển tích cực, sử dụng cho các dịch vụ Azure
- JSON Schema: Dành cho định nghĩa cấu trúc dữ liệu
- AsyncAPI: Dành cho các API hướng sự kiện
Bài học cho tính bền vững của mã nguồn mở
Câu chuyện API Blueprint đóng vai trò như một lời nhắc nhở về tính mong manh của các dự án mã nguồn mở phụ thuộc nhiều vào các nhà tài trợ doanh nghiệp. Mặc dù dự án đã được mã nguồn mở về mặt kỹ thuật dưới giấy phép MIT , thực tế là sự phát triển cộng đồng không thể duy trì động lực sau khi sự hỗ trợ của doanh nghiệp biến mất.
Đối với các nhà phát triển hiện đang sử dụng API Blueprint , việc di chuyển sang các giải pháp thay thế được duy trì tích cực như OpenAPI hoặc TypeSpec trở nên ngày càng cần thiết khi hệ sinh thái tiến về phía trước mà không có đảm bảo tương thích ngược.
Tham khảo: api blueprint