Apidog

Nền tảng phát triển API hợp tác tất cả trong một

Thiết kế API

Tài liệu API

Gỡ lỗi API

Giả lập API

Kiểm thử API tự động

Giả lập API với dữ liệu phức tạp trong vài phút

Khám phá cách dễ dàng giả lập các API phức tạp chỉ trong vài phút với Apidog. Hướng dẫn này giúp bạn nhập định nghĩa API, tùy chỉnh quy tắc giả lập cho enum, mảng và đối tượng tham chiếu schema, và tạo URL giả lập—không cần lập trình.

@apidog

@apidog

Updated on tháng 11 6, 2024

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:

  1. Nhập định nghĩa API.
  2. Tùy chỉnh quy tắc giả lập API cho các trường cụ thể.
  3. 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.

Nhập các thông số openAPI vào Apidog

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.

Tùy chỉnh giá trị enum cho việc giả lập API tại Apidog

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.

Tùy chỉnh quy tắc giả lập API tại Apidog

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'.

Tham chiếu đến các sơ đồ khác cho các trường cụ thể để giả lập API

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".

Lấy URL giả lập API đã cấu hình tại Apidog

Dán URL vào trình duyệt của bạn, và bạn đã hoàn thành.

Ví dụ về dữ liệu giả lập API sử dụng Apidog

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ư citycreatedAt, đượ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.

Làm mới để cập nhật dữ liệu giả lập API tại Apidog

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.

Giả lập dữ liệu XML tại Apidog

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.

button
Công cụ kiểm tra API miễn phí tốt nhất năm 2024 (Miễn phí)Hướng dẫn

Công cụ kiểm tra API miễn phí tốt nhất năm 2024 (Miễn phí)

Bài viết này nêu bật một số công cụ kiểm tra API miễn phí tốt nhất hiện có. Apidog cung cấp khả năng xây dựng yêu cầu API, mô phỏng, ghi lại, tự động hóa và xác thực.

@apidog

tháng 9 5, 2023

Mới! Apidog hiện đã có mặt bằng tiếng NhậtHướng dẫn

Mới! Apidog hiện đã có mặt bằng tiếng Nhật

Vào ngày 25 tháng 4 năm 2023, phiên bản 2.2.34 của Apidog đã được phát hành, và giao diện giờ có sẵn bằng tiếng Nhật. Điều này giúp người dùng Nhật Bản trải nghiệm việc phát triển API hiệu quả và trực quan hơn.

@apidog

tháng 4 25, 2023

Giả lập API trong ONE Phút mà không cần lập trìnhHướng dẫn

Giả lập API trong ONE Phút mà không cần lập trình

Các nhà phát triển front-end thường gặp phải một thách thức chung: API đã được thiết kế nhưng chưa được triển khai. Để tạo ra một giao diện người dùng chức năng, các nhà phát triển cần phải tạo dữ liệu giả, điều này thường liên quan đến việc thiết lập một máy chủ giả và tạo các ví dụ phản hồi. Trong những trường hợp mà tài liệu API thiếu ví dụ rõ ràng, các nhà phát triển phải tự nghĩ ra dữ liệu phản hồi, điều này dẫn đến sự thất vọng và không hiệu quả. Mỗi khi tôi gặp phải tình huống này, tôi k

@apidog

tháng 12 1, 2022