Nhiều nhà phát triển đã thấy blog trước đây của chúng tôi, "Giả lập một API chỉ trong MỘT phút," hữu ích và bạn cũng có thể như vậy. Blog đó đã đề cập đến một cách nhanh chóng để giả lập một API, nhưng chỉ mới là bề mặt. Khi tôi đào sâu hơn vào Apidog, tôi đã phát hiện ra các tính năng bổ sung giúp việc giả lập dữ liệu phức tạp nhanh hơn.
Xử lý API với Dữ liệu JSON Phức tạp
Chúng ta hãy bắt đầu với cách nhập một API Swagger vào Apidog để giả lập dữ liệu JSON. Bằng cách này, bạn có thể tạo dữ liệu giả lập mà không cần viết bất kỳ kịch bản nào.
Tuy nhiên, một số trường có thể khó giả lập mà không cần cấu hình bổ sung. Ví dụ:
- Các trường Enum với nhiều giá trị khả dĩ, thường được sử dụng cho các trường trạng thái.
- Mảng có độ dài cố định, giống như một bảng mà mỗi hàng có một số thuộc tính và một trang có thể hiển thị 20 hoặc 50 hàng.
- Các đối tượng tham chiếu đến sơ đồ, như quy định bởi thông số OpenAPI, nơi một đối tượng hoặc một phần của đối tượng tham chiếu đến một sơ đồ.
May mắn thay, với Apidog, bạn có thể giả lập những trường JSON phức tạp này chỉ trong hai phút.
Cách Giả lập API với Dữ liệu JSON Phức tạp Nhanh chóng?
Dưới đây là quy trình ba bước đơn giản để giả lập các API phức tạp bằng Apidog:
- Nhập định nghĩa API.
- Tùy chỉnh quy tắc giả lập API cho các trường cụ thể.
- Lấy URL giả lập.
Dễ dàng như vậy. Chúng ta hãy cùng tìm hiểu.
Bước 1: Nhập Định nghĩa API
Bạn chỉ cần một tệp OpenAPI JSON hoặc YAML. Nhập nó vào Apidog, và bạn đã sẵn sàng.
Bước 2: Tùy chỉnh Quy tắc Giả lập API cho Các Trường Cụ thể
Giá trị Enum:
Trong API mẫu của chúng tôi, trường 'status' có ba tùy chọn: có sẵn, đang chờ, và đã bán. Chúng tôi muốn dữ liệu giả lập của mình chỉ phản ánh một trong những giá trị này.
Nhấn 'Cài đặt nâng cao' trong trường 'Status', bật công tắc 'Enum', và thêm các giá trị enum. Bây giờ, trường này sẽ chỉ giả lập một trong những giá trị này.
Mảng có độ dài cố định:
Đối với trường mảng 'PhotoUrls', chúng tôi cần chính xác năm mục.
Trong 'Cài đặt nâng cao' của trường 'PhotoUrls', điều chỉnh cài đặt 'Giới hạn Phần tử'. Đặt cả 'minItems' và 'maxItems' thành 5.
Các đối tượng tham chiếu sơ đồ:
Apidog hỗ trợ các sơ đồ theo thông số OpenAPI. Nếu một đối tượng tham chiếu đến một sơ đồ, Apidog sẽ giả lập nó theo cách tương ứng. Ví dụ, bạn có thể tham chiếu đến sơ đồ cho trường 'Category'.
Bước 3: Lấy URL Giả lập API
Nhấn ‘Lưu', và chuyển đến tab 'Endpoint'. Sao chép URL dưới phần "Giả lập Cục bộ", bắt đầu bằng "127.0.0.1".
Dán URL vào trình duyệt của bạn, và bạn đã hoàn thành.
Các Trường Nổi Bật
Khi bạn kiểm tra dữ liệu giả lập, bạn sẽ nhận thấy:
- PhotoUrls có chính xác 5 mục, tất cả đều có URL hình ảnh hợp lệ.
- Status bị giới hạn trong một trong các giá trị enum (đã bán, đang chờ, hoặc có sẵn).
- Category tham chiếu đến sơ đồ đúng.
Các trường khác, như city và createdAt, được giả lập tự động.
Và nếu bạn làm mới URL, dữ liệu giả lập sẽ được cập nhật.
Apidog Hỗ trợ Giả lập Sơ đồ JSON cho API
Apidog hoàn toàn tương thích với OpenAPI 3.0, sử dụng Sơ đồ JSON để xác định cấu trúc dữ liệu API. Tất cả các thuộc tính Sơ đồ JSON đều được Apidog hỗ trợ, bao gồm:
- Phạm vi độ dài chuỗi, định dạng và mẫu (regex)
- Giá trị số nguyên tối thiểu và tối đa
- Cài đặt chỉ đọc/ghi chỉ
Không chỉ JSON, Apidog còn hỗ trợ giả lập XML. Bạn thậm chí có thể tùy chỉnh tên và tiền tố của thẻ XML.
Cảm ơn Sơ đồ JSON, bạn có thể tạo bất kỳ dữ liệu giả lập phức tạp nào chỉ với vài cú nhấp chuột sử dụng Apidog—không cần mã hóa.