Dựa trên nền tảng đã xây dựng vào tháng 1, tháng 2 này chúng tôi tập trung mạnh vào trải nghiệm MCP và kiểm thử—mang lại thông tin gỡ lỗi phong phú hơn, khả năng thực thi song song cho Bộ kiểm thử (Test Suites), dữ liệu kiểm thử dùng chung trên các kịch bản, báo cáo kiểm thử được thiết kế lại hoàn toàn, và khả năng di chuyển liền mạch từ Hoppscotch.
Chào mừng các bạn sử dụng Apidog,
Tháng 1 đã giới thiệu MCP Client và Bộ kiểm thử (Test Suites). Tháng 2 này tập trung vào việc đưa chúng vào trạng thái sẵn sàng cho sản xuất.
Chúng tôi đã tinh chỉnh trải nghiệm gỡ lỗi MCP với các bản xem trước nội dung phong phú hơn—hiển thị Markdown, hiển thị hình ảnh và truy cập trực tiếp trường Content. Bộ kiểm thử (Test Suites) hiện hỗ trợ thực thi song song để chạy kiểm thử hồi quy nhanh hơn đáng kể. Hệ thống Dữ liệu kiểm thử dùng chung (Shared Test Data) mới loại bỏ việc thiết lập dữ liệu trùng lặp trên các kịch bản. Và báo cáo kiểm thử đã được thiết kế lại hoàn toàn từ đầu với hiển thị bước có cấu trúc và lọc lỗi.
Bên cạnh đó, chúng tôi đã phát hành tính năng nhập Collection từ Hoppscotch, cải tiến gỡ lỗi SSE và một danh sách dài các bản sửa lỗi nhỏ cải thiện trải nghiệm người dùng trong tám bản phát hành trong tháng này.
Dưới đây là tất cả những tính năng mới trong tháng này👇
⭐ Cập nhật mới
🔥 Trải nghiệm gỡ lỗi MCP Client được tinh chỉnh
Khi gỡ lỗi MCP Servers bằng MCP Client tích hợp của Apidog, trải nghiệm xem phản hồi đã được nâng cấp toàn diện với các khả năng xem trước và xác minh nội dung tiện lợi hơn.
1. Xem trực tiếp trường Content
Khi gỡ lỗi một MCP Server trong Apidog, giờ đây bạn có thể xem trường Content của phản hồi trực tiếp trong tab **"Content"**—không cần phải tìm kiếm trong JSON thô để tìm thấy những gì bạn cần nữa. Tab **"Raw"** vẫn cung cấp toàn bộ JSON-RPC payload để kiểm tra sâu, mang lại cho bạn sự tiện lợi tối đa tùy thuộc vào ngữ cảnh gỡ lỗi của bạn.
2. Xem trước hiển thị Markdown
Khi một phản hồi MCP chứa nội dung Markdown, giờ đây bạn có thể **chuyển đổi giữa Markdown thô và bản xem trước đã được hiển thị**. Điều này giúp dễ dàng xác minh trực quan tài liệu được định dạng, nội dung README hoặc bất kỳ văn bản có cấu trúc nào được trả về bởi các công cụ MCP của bạn—mà không cần rời khỏi trình gỡ lỗi.
3. Xem trước hình ảnh
Hình ảnh trong phản hồi MCP giờ đây được **hiển thị trực tiếp trong tab "Preview"**, cho phép nhà phát triển nhanh chóng xác minh nội dung và định dạng hình ảnh mà không cần công cụ bên ngoài. Điều này đặc biệt hữu ích khi gỡ lỗi các công cụ MCP trả về ảnh chụp màn hình, biểu đồ hoặc hình ảnh được tạo ra.
Cùng với nhau, ba cải tiến này biến MCP Client từ một công cụ kiểm tra giao thức thô thành một môi trường gỡ lỗi có độ chính xác cao—nơi bạn có thể thấy chính xác những gì các tác nhân AI của bạn thấy.
🚀 Bộ kiểm thử (Test Suites): Thực thi song song & Lập lịch dựa trên môi trường
Tiếp nối sự ra mắt của Bộ kiểm thử (Test Suite) vào tháng 1, chúng tôi đang bổ sung hai khả năng giúp việc điều phối trở nên mạnh mẽ hơn đáng kể.
Chế độ thực thi song song
Bộ kiểm thử (Test Suites) hiện hỗ trợ **chế độ chạy "Song song"**, cho phép nhiều trường hợp kiểm thử và kịch bản thực thi đồng thời. Bạn có thể linh hoạt cấu hình các quy tắc thực thi song song để giảm đáng kể thời gian kiểm thử tổng thể—đặc biệt hữu ích cho các bộ kiểm thử hồi quy quy mô lớn, nơi việc thực thi tuần tự trở thành nút thắt cổ chai.
So sánh các chế độ chạy:
| Chế độ | Hành vi |
|---|---|
| Tuần tự | Các kịch bản chạy theo thứ tự. Các biến tồn tại và lan truyền qua các bước kịch bản—lý tưởng cho các quy trình làm việc phụ thuộc. |
| Song song | Nhiều kịch bản chạy đồng thời để đạt tốc độ tối đa. Lưu ý: việc chạy song song cách ly ngữ cảnh giữa các kịch bản—các trường hợp phụ thuộc vào các biến đầu nguồn có thể cần được cấu trúc lại. |
Lưu ý: Tốc độ tăng thực tế phụ thuộc vào tài nguyên phần cứng có sẵn của máy chạy kiểm thử.
Các tác vụ đã lên lịch giờ đây hỗ trợ lựa chọn môi trường
Khi tạo các tác vụ đã lên lịch cho Bộ kiểm thử (Test Suites), giờ đây bạn có thể **chọn môi trường mục tiêu**, cho phép kiểm soát chính xác việc thực thi tự động trên các môi trường khác nhau (ví dụ: staging, production). Điều này có nghĩa là bạn có thể lên lịch cho cùng một bộ kiểm thử chạy trên nhiều môi trường với tần suất khác nhau—một khả năng quan trọng đối với các nhóm quản lý các quy trình triển khai đa giai đoạn.
🆕 Dữ liệu kiểm thử dùng chung (Shared Test Data): Khả năng tái sử dụng trên nhiều kịch bản
Một khả năng hoàn toàn mới trong bản phát hành này: **Dữ liệu kiểm thử dùng chung (Shared Test Data)**. Giờ đây bạn có thể tạo các bộ dữ liệu kiểm thử chung có thể tái sử dụng trên nhiều kịch bản kiểm thử, thay đổi cơ bản cách các nhóm quản lý dữ liệu kiểm thử ở quy mô lớn.
Tại sao điều này quan trọng:
Trước đây, mỗi kịch bản kiểm thử duy trì dữ liệu kiểm thử riêng biệt. Nếu mười kịch bản cần cùng thông tin đăng nhập người dùng, chi tiết thanh toán hoặc danh mục sản phẩm, bạn phải sao chép dữ liệu đó mười lần—và duy trì nó ở mười nơi.
Dữ liệu kiểm thử dùng chung giải quyết vấn đề này bằng cách giới thiệu một lớp dữ liệu tập trung:
- Tạo một lần, sử dụng mọi nơi: Định nghĩa một bộ dữ liệu một lần và tham chiếu nó từ bất kỳ kịch bản kiểm thử nào trong dự án của bạn.
- Nguồn dữ liệu duy nhất: Cập nhật dữ liệu dùng chung ở một nơi, và mọi kịch bản tham chiếu đến nó sẽ tự động nhận thay đổi.
- Kiểm thử tiêu chuẩn hóa: Đảm bảo tất cả các kịch bản kiểm thử dựa trên dữ liệu nhất quán, đã được xác thực—loại bỏ những sai lệch nhỏ do việc sao chép/dán gây ra.
Điều này đặc biệt mạnh mẽ khi kết hợp với chế độ thực thi song song mới, vì dữ liệu dùng chung cung cấp một nền tảng ổn định cho các lần chạy kiểm thử đồng thời.
📊 Báo cáo kiểm thử: Thiết kế lại hoàn toàn
Trải nghiệm báo cáo kiểm thử đã được **xây dựng lại từ đầu** trong tháng này, được phát hành trong hai bản cập nhật (v2.8.4 và v2.8.11).
Hiển thị bước có cấu trúc (v2.8.4)
Toàn bộ giao diện người dùng của báo cáo kiểm thử đã được thiết kế lại để hỗ trợ **hiển thị có cấu trúc tất cả các bước kiểm thử**. Thay vì một nhật ký phẳng, giờ đây bạn thấy một chế độ xem phân cấp phản ánh luồng thực thi thực tế—giúp bạn dễ dàng nhận biết ngay lập tức kịch bản, trường hợp và bước nào đã tạo ra mỗi kết quả. Danh sách báo cáo kiểm thử cũng đã được tối ưu hóa với khả năng hiển thị và lọc có cấu trúc.
Lọc trường hợp thất bại (v2.8.11)
Dựa trên nền tảng được thiết kế lại, chúng tôi đã bổ sung **bộ lọc trường hợp thất bại** và **kiểm tra chi tiết từng bước**, giúp bạn nhanh chóng tập trung vào các lỗi và hiểu chính xác điều gì đã sai ở mỗi bước.
Báo cáo tự động điều chỉnh hiển thị dựa trên ngữ cảnh xem của bạn:
- Xem tất cả các bước: Được trình bày dưới dạng **cấu trúc cây** thể hiện rõ ràng thứ bậc các bước và ngữ cảnh thực thi.
- Lọc các trường hợp thất bại: Tự động chuyển sang **danh sách phẳng** tổng hợp tất cả các bước thất bại để nhận diện vấn đề nhanh chóng.
Sự kết hợp giữa hiển thị có cấu trúc và lọc thông minh có nghĩa là bạn có thể chuyển từ "bộ kiểm thử thất bại" sang "đây là khẳng định chính xác đã bị lỗi" trong vài giây thay vì vài phút.
🔗 Nhập Hoppscotch Collection
Đối với các nhóm di chuyển từ Hoppscotch, Apidog hiện hỗ trợ **nhập trực tiếp Hoppscotch Collections**. Chỉ cần xuất các collection của bạn từ Hoppscotch và nhập chúng vào Apidog—các endpoint, tham số, tiêu đề và nội dung yêu cầu của bạn sẽ được giữ nguyên, giúp quá trình chuyển đổi diễn ra liền mạch.
Điều này bổ sung vào hỗ trợ nhập hiện có của chúng tôi cho Postman, Swagger/OpenAPI, Insomnia và các định dạng khác, củng cố vị trí của Apidog như một nền tảng API phổ quát, đáp ứng nhu cầu của bạn ở mọi nơi.
⚡️ Tối ưu hóa
Ngoài các tính năng nổi bật, chúng tôi còn triển khai một loạt cải tiến nhỏ nâng cao trải nghiệm người dùng:
- Giao diện người dùng cho nhánh được bảo vệ (Protected Branch UI): Thiết kế lại tương tác với nhánh được bảo vệ để có quy trình làm việc sạch sẽ, trực quan hơn.
- Trải nghiệm người dùng trường chung cài sẵn (Preset Common Fields UX): Cải thiện giao diện để áp dụng các trường chung cài sẵn cho các endpoint, giảm thiểu sự phức tạp trong việc tái sử dụng schema.
- Đối tượng toàn cục `crypto` trong script: Các script tiền xử lý và hậu xử lý giờ đây hỗ trợ đối tượng toàn cục `crypto`, cho phép thực hiện các phép toán mật mã (hashing, HMAC, mã hóa) trực tiếp trong script kiểm thử của bạn mà không cần phụ thuộc bên ngoài.
- Gỡ lỗi SSE: Khi gỡ lỗi các endpoint SSE (Server-Sent Events), Apidog giờ đây xử lý chính xác các ngắt dòng `\r\n`, đảm bảo phân tích luồng sự kiện chính xác.
- Quy trình mời dự án (Project Invitation Flow): Tối ưu hóa quy trình mời cộng tác viên tham gia dự án, giúp việc gia nhập nhóm diễn ra suôn sẻ hơn.
- Danh sách báo cáo kiểm thử: Chế độ xem danh sách báo cáo kiểm thử giờ đây hỗ trợ hiển thị có cấu trúc và lọc, giúp dễ dàng điều hướng qua lịch sử kiểm thử lớn.
🐞 Sửa lỗi
Chúng tôi đã giải quyết tổng cộng **17 lỗi** trong tám bản phát hành trong tháng này. Dưới đây là những điểm nổi bật:
Kiểm thử & Tự động hóa:
- Đã khắc phục lỗi **số vòng lặp hiển thị là 0** trong báo cáo kiểm thử khi sử dụng
{{variable}}làm số lần lặp trong các kiểm thử tự động. - Đã khắc phục lỗi **không thể cấu hình xác thực phản hồi** khi chạy hàng loạt dữ liệu kiểm thử từ trang trường hợp kiểm thử.
- Đã khắc phục lỗi **endpoint yêu cầu tùy chỉnh đôi khi không bao gồm xác thực** trong quá trình thực thi kịch bản kiểm thử tự động nếu endpoint không chuyển sang xác thực.
Nhập & Xuất dữ liệu:
- Đã khắc phục lỗi **không thể nhập tệp RAML** vào Apidog.
- Đã khắc phục lỗi **Hoppscotch Collections không thể nhập** trong một số trường hợp nhất định.
- Đã khắc phục lỗi **khi tạo mã SQL từ một schema** không sử dụng tên schema làm tên bảng, dẫn đến tất cả tên bảng đều là
tableName.
Endpoint & Gỡ lỗi:
- Đã khắc phục lỗi **nội dung phản hồi của các endpoint Socket không được định dạng**.
- Đã khắc phục lỗi **trường nhập tham số header bị mất tiêu điểm** sau khi gõ ký tự đầu tiên khi tên trường là tiếng Anh.
- Đã khắc phục lỗi **khi lưu trực tiếp một yêu cầu nhanh vào thư mục con** sẽ di chuyển không chính xác nó vào thư mục gốc (v2.8.9).
- Đã khắc phục lỗi **khi đổi tên một yêu cầu nhanh** đôi khi không được lưu.
Nền tảng & Quản trị:
- Đã khắc phục lỗi **500** xảy ra trong một số trường hợp khi cấu hình vai trò tùy chỉnh ở cấp tổ chức.
- Đã khắc phục lỗi **các nhánh đã xóa không giải phóng liên kết URL tùy chỉnh SEO** từ các endpoint.
- Đã khắc phục xác thực URL trong cấu hình điều hướng tài liệu đã xuất bản.
🌟 Định hướng tương lai
Tám bản phát hành trong tháng 2 phản ánh cam kết của chúng tôi trong việc phát hành nhanh chóng và lặp lại dựa trên phản hồi. Khi chúng tôi bước sang tháng 3, chúng tôi sẽ tiếp tục đào sâu trải nghiệm gỡ lỗi MCP, mở rộng khả năng điều phối Bộ kiểm thử (Test Suite), và đầu tư vào các quy trình làm việc tích hợp AI sẽ định hình thế hệ phát triển API tiếp theo.
Chúng tôi cũng đang tích cực làm việc về việc tích hợp Git sâu hơn và chỉnh sửa ở chế độ văn bản để phù hợp với thói quen phát triển ưu tiên Git—hãy theo dõi.
💬 Tham gia cuộc trò chuyện
Kết nối với các kỹ sư API khác và đội ngũ Apidog:
- Tham gia cộng đồng Discord của chúng tôi để thảo luận theo thời gian thực.
- Tham gia cộng đồng Slack của chúng tôi để tìm hiểu sâu về kỹ thuật.
- Theo dõi chúng tôi trên X (Twitter) để nhận các cập nhật mới nhất.
Tái bút: Khám phá chi tiết đầy đủ của tất cả các cập nhật này trong Apidog Changelog! 🚀
Chúc bạn xây dựng API hiệu quả!
Trân trọng,
Đội ngũ Apidog