Trong suốt Apidog 2.8.47–2.8.50, các bản cập nhật tháng này giúp việc tự động hóa API, tích hợp kho lưu trữ và tài liệu API dễ bảo trì hơn—từ các bản nhập CLI module hóa và tạo trường hợp gỡ lỗi đến Bitbucket Cloud, kết nối GitLab tự lưu trữ và lược đồ được xuất bản từ các trang con của Docs.
Bản phát hành này tập trung vào việc làm cho quá trình tự động hóa và cộng tác Git bớt đi những bước thiết lập rườm rà.
Các bản cập nhật Apidog tháng 9 tập trung vào những điểm mà các nhóm thường mất thời gian: quản lý cấu trúc dự án lớn từ tập lệnh hoặc quy trình làm việc AI, nhập tài sản API vào đúng module, tạo tài sản thử nghiệm mà không cần rời khỏi terminal và kết nối các nhà cung cấp Git hiện có mà không làm thay đổi cách các nhóm đang làm việc.
Tổng quan:
- Tự động hóa Apidog CLI: quản lý các module dự án, nhập dữ liệu API đa định dạng theo module và tạo các trường hợp kiểm thử gỡ lỗi từ các tệp cấu hình.
- Tích hợp kho lưu trữ Git: thêm kết nối Bitbucket Cloud và GitLab On-Prem vào quy trình nhập/xuất dự án.
- Khả năng sử dụng hàng ngày: xử lý URL rõ ràng hơn, lọc báo cáo kiểm thử tốt hơn, hoàn thành biến dữ liệu kiểm thử và danh sách dự án nhanh hơn.
- Khả năng hiển thị tài liệu và hiệu suất: các trang con của Docs xuất bản lược đồ, và các bài kiểm tra hiệu suất báo cáo thời gian phản hồi P95 và P99.
🤖 Apidog CLI cho Tự động hóa API và Quy trình làm việc AI
Apidog CLI đã trở thành một điểm truy cập hữu ích cho các lần chạy kiểm thử CI và tự động hóa. Bản phát hành này mở rộng nó sớm hơn trong quy trình làm việc: các nhóm có thể quản lý cấu trúc dự án, đưa dữ liệu vào đúng module và tạo các trường hợp gỡ lỗi trước khi chạy kiểm thử.
Quản lý các module dự án từ CLI
Apidog CLI giờ đây có thể truy vấn, tạo, cập nhật và xóa các module dự án.
Điều này hữu ích khi cấu trúc module cần thay đổi như một phần của quy trình làm việc tự động. Sau một thao tác ghi, CLI trả về JSON có cấu trúc bao gồm moduleId, để các tập lệnh và tác nhân có thể chuyển mã định danh vào các bước nhập, kiểm thử hoặc bảo trì sau này thay vì yêu cầu ai đó sao chép từ giao diện người dùng.
Điều đó làm cho việc quản lý module trở thành một phần của cùng một vòng lặp lặp lại như kiểm thử API và tự động hóa CI.
Nhập dữ liệu API vào một module được chọn
Lệnh nhập của CLI đã được tái cấu trúc để sử dụng lại khả năng phân tích cú pháp của máy khách Apidog. Bạn có thể nhập dữ liệu API từ các nguồn được hỗ trợ vào một module dự án được chỉ định thay vì tạo dữ liệu trong giao diện người dùng trước rồi di chuyển sau.
Đối với các lần di chuyển lớn hơn, kết quả nhập bao gồm số lượng các mục được thêm, cập nhật, bỏ qua và xóa. Điều đó giúp các tập lệnh, tác vụ CI và tác nhân AI dễ dàng xác minh những gì đã xảy ra trước khi chuyển sang bước tiếp theo.
Điều này đặc biệt hữu ích khi nhiều định dạng cần được đưa vào cùng một cấu trúc dự án với ít bước dọn dẹp thủ công hơn.
Tạo các trường hợp kiểm thử gỡ lỗi từ cấu hình
Người dùng CLI giờ đây có thể tạo các trường hợp kiểm thử gỡ lỗi giao diện từ các tệp cấu hình. Một cấu hình có thể định nghĩa tên trường hợp, API mục tiêu, tham số yêu cầu, nội dung yêu cầu, xác thực, bộ tiền xử lý, bộ hậu xử lý và xác thực phản hồi.
Sau khi tạo, trường hợp gỡ lỗi có thể được mở, chỉnh sửa và thực thi trong Apidog giống như bất kỳ trường hợp gỡ lỗi nào khác. Điều này hữu ích khi tự động hóa hoặc một tác nhân chuẩn bị tài sản kiểm thử ban đầu, nhưng một nhà phát triển vẫn muốn kiểm tra và tinh chỉnh nó bằng hình ảnh.
Cùng với nhau, việc quản lý module, nhập có cấu trúc và tạo trường hợp gỡ lỗi giảm bớt công việc thủ công trên các tập lệnh cục bộ, đường ống CI/CD và quy trình làm việc được hỗ trợ bởi AI.
Nếu bạn đã cài đặt Apidog CLI, hãy cập nhật nó trước khi sử dụng các khả năng mới:
npm install -g apidog-cli@latestXem tài liệu Apidog CLI để biết tham chiếu lệnh mới nhất.
🔗 Tích hợp Kho lưu trữ Git
Tháng 9 cũng mở rộng tính năng nhập/xuất dựa trên Git sang hai môi trường kho lưu trữ phổ biến.
Bitbucket Cloud
Nhập và xuất dự án giờ đây hỗ trợ các kho lưu trữ Bitbucket Cloud. Các nhóm đã sử dụng Bitbucket Cloud có thể giữ các kho lưu trữ hiện có của họ trong quy trình làm việc thay vì di chuyển tài sản API sang một nền tảng Git khác.
GitLab On-Prem
Các tổ chức có thể cấu hình một phiên bản GitLab On-Prem trong Apidog SaaS và sử dụng nó trong các quy trình làm việc kho lưu trữ Git được hỗ trợ. Mỗi tổ chức quản lý kết nối của riêng mình một cách độc lập, vì vậy các nhóm có thể tiếp tục sử dụng thiết lập GitLab tự lưu trữ hiện có của họ.
Trước khi kết nối, hãy xác nhận rằng địa chỉ phiên bản GitLab và môi trường mạng đáp ứng các yêu cầu kết nối.
⚙️ Cải tiến hàng ngày
Bản phát hành cũng giải quyết các phản hồi thường xuyên từ công việc API hàng ngày.
Các URL đầy đủ không còn xung đột với đường dẫn môi trường
Khi tạo hoặc chỉnh sửa một API HTTP, việc nhập một URL đầy đủ bắt đầu bằng http:// hoặc https:// giờ đây sẽ ẩn đường dẫn môi trường ngay lập tức. Thay đổi giá trị trở lại đường dẫn tương đối sẽ khôi phục đường dẫn môi trường.
Điều này loại bỏ sự nhầm lẫn khi thấy một URL đầy đủ và một đường dẫn môi trường cùng một lúc, và loại bỏ sự cần thiết phải lưu trước để xem hành vi.
Lọc báo cáo kiểm thử hữu ích hơn
Danh sách báo cáo kiểm thử giờ đây hỗ trợ lọc theo người chạy và nguồn thực thi. Các trường hiển thị liên quan cũng đã được thêm vào, giúp việc thu hẹp một danh sách báo cáo dài và so sánh các bản ghi gần đây từ các nguồn gốc khác nhau dễ dàng hơn.
Các biến dữ liệu kiểm thử xuất hiện trong phần hoàn thành
Các biến dữ liệu kiểm thử hiện có giờ đây xuất hiện trong cả phần tự động hoàn thành mã và tự động hoàn thành giá trị động. Khi viết yêu cầu hoặc kiểm thử, bạn có thể tìm kiếm và chọn biến trực tiếp thay vì chuyển về danh sách biến để sao chép tên của nó.
Danh sách dự án nhanh hơn
Apidog đã tối ưu hóa thời gian phản hồi của API danh sách dự án. Danh sách dự án tải nhanh hơn khi vào một không gian làm việc hoặc định vị một dự án, giảm thời gian chờ đợi trong quá trình điều hướng và chuyển đổi thường xuyên.
✨ Cũng trong Bản phát hành này
Ba thay đổi làm tròn tháng này, bao gồm tài liệu, kiểm thử hiệu suất và thiết lập dự án theo hướng đặc tả.
Xuất bản lược đồ từ các trang con của Docs
Các trang con trong Apidog Docs giờ đây có thể xuất bản lược đồ cùng với các điểm cuối, vì vậy người đọc một trang đã xuất bản có thể xem chúng tại chỗ thay vì chuyển về trang chính. Các trang con của doanh nghiệp có thể tự bật khả năng này.
Thời gian phản hồi P95 và P99 trong kiểm thử hiệu suất
Kết quả kiểm thử hiệu suất giờ đây báo cáo thời gian phản hồi P95 và P99 cùng với các chỉ số hiện có. Phần trăm mô tả phần chậm mà các giá trị trung bình che giấu, đây thường là phần của một API mà người dùng thực sự chú ý.
Thiết lập dự án Chế độ đặc tả và nhập OpenAPI
Các dự án Chế độ đặc tả giờ đây mở ra một trạng thái trống rõ ràng hơn, với các điểm nhập nhập OpenAPI và tạo được hiển thị trực tiếp, vì vậy một dự án theo hướng đặc tả có thể bắt đầu mà không cần tìm kiếm lối vào.
🛠️ Các Sửa lỗi và Cải tiến bổ sung
Chu kỳ này cũng bao gồm các sửa lỗi và thay đổi nhỏ hơn sau đây:
- Cải thiện cách hiển thị trạng thái và hành động dùng thử trong cửa sổ chính và thanh tab.
- Cải thiện cách các lời mời đang chờ xử lý xuất hiện trong danh sách thành viên tổ chức và nhóm.
- Đã khắc phục sự cố trong đó các biến Basic Auth trong mã yêu cầu được tạo không được mở rộng và được mã hóa trực tiếp dưới dạng Base64.
- Đã khắc phục sự cố trong đó việc chỉnh sửa một tab không mở rộng các trường mô hình dữ liệu kết hợp được tham chiếu bằng
allOf. - Đã khắc phục sự cố trong đó các tham chiếu chéo dự án API đến các mô hình dữ liệu không chính xác sau khi nhân bản hoặc sao chép một dự án.
- Đã khắc phục sự cố trong đó các trường hợp gỡ lỗi được tạo bởi CLI hiển thị loại xác thực là "Không xác thực" trên máy khách Web và không áp dụng xác thực.
- Đã khắc phục sự cố trong đó các định nghĩa
$refphản hồi OpenAPI bị loại bỏ một cách âm thầm trong quá trình nhập CLI. - Đã khắc phục sự cố trong đó siêu dữ liệu phân trang danh sách báo cáo trả về các giá trị
pageSizevàpageIndexkhông chính xác. - Đã khắc phục sự cố trong đó việc tạo cả báo cáo kiểm thử JUnit và HTML khiến báo cáo JUnit chỉ chứa kết quả trường hợp kiểm thử cuối cùng.
- Đã khắc phục sự cố trong đó danh sách thả xuống môi trường không thể mở khi chuyển đổi môi trường URL trong kiểm thử API đơn lẻ.
- Đã thêm hỗ trợ để tắt mục phần thưởng mời trang chủ thông qua Chính sách Doanh nghiệp.
Để có danh sách đầy đủ từng mục, hãy khám phá Nhật ký thay đổi của Apidog.
🌟 Ý nghĩa của điều này
Tháng 9 là một bản phát hành thiết thực dành cho các nhóm có công việc ngày càng mở rộng giữa con người, tập lệnh, tác nhân và kho lưu trữ Git.
| Trọng tâm | Điều gì được cải thiện | Tại sao nó quan trọng |
|---|---|---|
| CLI và tự động hóa | Các module, bản nhập và trường hợp gỡ lỗi có thể được tạo và quản lý thông qua CLI. | Tự động hóa và các tác nhân có thể tham gia sớm hơn mà không cần thiết lập giao diện người dùng thủ công. |
| Cộng tác Git | Bitbucket Cloud và GitLab On-Prem kết nối với các quy trình làm việc của dự án. | Các nhóm có thể giữ các kho lưu trữ mà họ đã vận hành. |
| Chất lượng hàng ngày | Xử lý URL, lọc báo cáo, hoàn thành biến và tải dự án được cải thiện. | Các bước thiết lập và xem xét chung ít cần chú ý hơn. |
| Tài liệu, kiểm thử và đặc tả | Lược đồ được xuất bản với các trang con của Docs, kết quả hiệu suất báo cáo P95 và P99, và Chế độ đặc tả có một khởi đầu rõ ràng hơn. | Lược đồ, độ trễ và ngữ cảnh theo hướng đặc tả hiển thị mà không cần rời khỏi quy trình làm việc. |
💬 Giữ liên lạc
Có phản hồi hoặc câu hỏi? Kết nối với các kỹ sư API đồng nghiệp và nhóm Apidog:
- Tham gia cộng đồng Discord của chúng tôi để thảo luận và hỗ trợ theo thời gian thực.
- Tham gia cộng đồng Slack của chúng tôi để trao đổi kỹ thuật.
- Theo dõi chúng tôi trên X (Twitter) và LinkedIn để nhận các bản cập nhật mới nhất.
Tái bút: Để biết mọi chi tiết trong bản phát hành này, hãy xem Nhật ký thay đổi của Apidog.
Trân trọng,
Đội ngũ Apidog