Kiểm thử hợp đồng được sử dụng để xác thực xem phản hồi API thực tế có tuân thủ đặc tả được định nghĩa trong tài liệu API (OpenAPI) hay không. Bằng cách thực hiện các kiểm tra tính nhất quán trên các nội dung như mã trạng thái và cấu trúc phản hồi, tính năng này cho phép phát hiện kịp thời các điểm không nhất quán giữa phần triển khai và tài liệu trong các giai đoạn phát triển, gỡ lỗi và kiểm thử, qua đó bảo đảm hành vi API ổn định và đáng tin cậy giữa các dịch vụ.Khả năng Xác thực phản hồi (Kiểm thử hợp đồng) của Apidog được tích hợp sâu với tài liệu API. Tính năng này có thể được sử dụng trong Yêu cầu API, trong Trường hợp gỡ lỗi, Trường hợp kiểm thử và Bước kiểm thử tự động hóa. Đây là một tính năng nền tảng được bật theo mặc định.Bật Xác thực phản hồi#
Xác thực phản hồi có thể được bật theo mô-đun và được sử dụng ở các giai đoạn khác nhau dựa trên nhu cầu nghiệp vụ. Công tắc liên quan nằm trong "Settings -> Response Validation Settings".Yêu cầu API và Trường hợp gỡ lỗi#
Khi được bật, tính năng "Validate Response" khả dụng trong các chế độ xem "Request" và "Debug Case" thuộc mô-đun APIs, được dùng để xác minh tính nhất quán của phản hồi trong giai đoạn gỡ lỗi.Trường hợp kiểm thử#
Khi được bật, "Validate Response" có thể được thực thi trong "Test Cases" thuộc mô-đun APIs để xác minh hành vi API trong quá trình kiểm thử thủ công.Bước kiểm thử tự động hóa#
Khi được bật, "Validate Response" có thể được thêm dưới dạng Bước kiểm thử trong mô-đun Tests, tích hợp Xác thực phản hồi vào toàn bộ quy trình kiểm thử tự động hóa.Xác thực nội dung phản hồi#
Xác thực phản hồi của Apidog sẽ tự động thực hiện các kiểm tra sau dựa trên đặc tả OpenAPI được định nghĩa trong tài liệu API:Xác thực mã trạng thái HTTP của phản hồi#
Kiểm tra xem mã trạng thái HTTP của phản hồi thực tế có nhất quán với mã trạng thái được định nghĩa trong tài liệu hay không. Ví dụ:Tài liệu định nghĩa 200, nhưng kết quả trả về thực tế là 204
Tài liệu định nghĩa nhiều giá trị khả dĩ (ví dụ: 200, 201, 400, 403), xác thực theo phạm vi được phép
Xác thực Schema của body phản hồi#
Xác thực các nội dung sau dựa trên Data Schema được định nghĩa trong tài liệu:Một trường có bắt buộc hay không
Giá trị của một trường có phải là null hay không
Kiểu của trường có chính xác hay không
Các trường bắt buộc có hiện diện hay không
Cấu trúc của Arrays và Objects có tuân thủ tài liệu hay không
Các giá trị enum có hợp lệ hay không
Kiểm soát các thuộc tính bổ sung trong Objects#
Đối với các trường kiểu Object:Nếu additionalProperties không được thiết lập trong tài liệu, bạn có thể chọn có cho phép phản hồi thực tế chứa các trường bổ sung không được định nghĩa trong tài liệu hay không.
Nếu additionalProperties được thiết lập, hệ thống sẽ xác thực việc cho phép các trường bổ sung theo các quy tắc của tài liệu.
Modified at 2026-06-11 10:23:06
