Sau khi tạo đặc tả endpoint hoặc nhập một đặc tả API, bạn có thể tạo và gửi các yêu cầu để gỡ lỗi và xác thực.Tạo tham số yêu cầu#
Trong
Chế độ Design-first của Apidog, sau khi bạn đã chỉ định một endpoint trong tab
Edit, bạn có thể nhấp vào tab
Run để chuyển sang giao diện gửi yêu cầu. Tại đây, yêu cầu tương ứng sẽ được tự động tạo dựa trên các đặc tả endpoint mà bạn đã định nghĩa.
Đối với các tham số path, tham số query, headers, và body thuộc loại form-data hoặc x-www-form-urlencoded, nếu bạn đã chỉ định một example trong đặc tả endpoint, ví dụ này sẽ tự động điền vào trường value trong giao diện Run dưới dạng giá trị tham số yêu cầu ban đầu.Nếu các tham số như tên tham số, mô tả, loại hoặc ví dụ trong đặc tả endpoint được sửa đổi và lưu trong tab Edit, các trường tương ứng trong tab Run cũng sẽ được cập nhật tương ứng. Mọi thay đổi được thực hiện trong đặc tả sẽ phản ánh xuyên suốt toàn bộ quy trình phát triển, duy trì tính nhất quán và độ chính xác.
Tạo body yêu cầu#
Nếu body yêu cầu của bạn thuộc loại JSON hoặc XML, bạn có thể tự động tạo body yêu cầu trong Apidog mà không cần xây dựng thủ công.Ví dụ body yêu cầu và nội dung ban đầu#
Nếu đặc tả endpoint của bạn bao gồm một ví dụ body đã được định nghĩa, ví dụ này sẽ xuất hiện trong tab
Run dưới dạng nội dung body ban đầu.
Nếu không có ví dụ body nào được định nghĩa trong đặc tả endpoint, trường body trong tab Run sẽ được để trống. Tuy nhiên, bạn có thể nhấp vào Auto-generate để tạo một cấu trúc body phù hợp với yêu cầu của mình.Tùy chọn Auto-generate#
Yêu cầu Apidog phiên bản 2.7.0 trở lên.
Apidog cung cấp nhiều tùy chọn tự động tạo dữ liệu nhằm đáp ứng các nhu cầu khác nhau. Bạn có thể chọn từ nhiều phương thức tạo trong menu thả xuống Auto-generate:1. Ví dụ#
Tính năng: Chọn thủ công một ví dụ body yêu cầu đã được định nghĩa sẵn.
Trường hợp sử dụng: Chuyển đổi thủ công giữa các ví dụ đã được định nghĩa sẵn cho các kịch bản nghiệp vụ khác nhau, chẳng hạn như yêu cầu thông thường, yêu cầu ngoại lệ hoặc kiểm thử giá trị biên.
2. Tạo mỗi lần#
Trường hợp sử dụng: Lý tưởng cho các yêu cầu dữ liệu động.
Lưu ý: Khi bật Generate Each Time, nội dung body sẽ không thể chỉnh sửa cho đến khi tùy chọn này bị tắt.
3. Tùy chọn ưu tiên tự động tạo#
Nhấp vào Auto-generation Preference sẽ mở một cửa sổ bật lên, nơi bạn có thể chọn các quy tắc mà bạn ưu tiên để tự động tạo dữ liệu.Ưu tiên dùng giá trị ví dụTính năng: Nếu các giá trị ví dụ được định nghĩa trong schema dữ liệu yêu cầu, chúng sẽ được sử dụng để tự động tạo. Nếu không có giá trị ví dụ nào được cấu hình, một giá trị ngẫu nhiên sẽ được tạo dựa trên các quy tắc Mock.
Trường hợp sử dụng: Lý tưởng cho các kịch bản trong đó một số trường cần giá trị cố định, trong khi các trường khác có thể được tạo động.
Ưu tiên dùng giá trị mặc địnhTính năng: Nếu các giá trị mặc định được định nghĩa trong schema dữ liệu yêu cầu, chúng sẽ được sử dụng để tự động tạo. Nếu không có giá trị mặc định nào được cấu hình, một giá trị ngẫu nhiên sẽ được tạo dựa trên các quy tắc Mock.
Trường hợp sử dụng: Phù hợp với các kịch bản gỡ lỗi trong đó cần giữ lại các giá trị đặt sẵn.
Tính năng: Tạo dữ liệu dựa trên quy tắc Smart Mock.
Trường hợp sử dụng: Nhanh chóng tạo dữ liệu kiểm thử hoàn chỉnh.
Tính năng: Chỉ tạo tên trường bằng schema dữ liệu yêu cầu, để trống các giá trị.
Trường hợp sử dụng: Hữu ích cho các kịch bản kiểm thử trong đó các giá trị cụ thể cần được điền thủ công.
Tính năng: Chọn ngẫu nhiên một ví dụ yêu cầu đã được định nghĩa sẵn.
Trường hợp sử dụng: Nhanh chóng chuyển đổi giữa các kịch bản nghiệp vụ khác nhau, chẳng hạn như yêu cầu thông thường hoặc yêu cầu ngoại lệ.
Chèn giá trị động#
Bạn có thể sử dụng Giá trị động để tạo giá trị cho cả tham số yêu cầu và body yêu cầu. Điều này cho phép các giá trị động được tự động mock và chèn vào yêu cầu mỗi khi yêu cầu được gửi.Bên cạnh ô nhập cho từng tham số yêu cầu, bạn sẽ thấy biểu tượng đũa thần dành cho biến động—nhấp vào biểu tượng này sẽ chèn một giá trị động.Tương tự, trong body yêu cầu, bạn có thể nhấp vào nút Insert Dynamic Value để chèn các giá trị động trong body JSON hoặc XML.Gửi yêu cầu#
Nhấp vào Send để gửi yêu cầu. Modified at 2026-06-11 10:23:06