Chuyển đến nội dung

Tạo mock REST API

Tạo endpoint JSON giả với phương thức, đường dẫn, mã trạng thái, độ trễ và nội dung do bạn đặt, hoặc dữ liệu giả được tạo sẵn. Endpoint chạy trên máy chủ của chúng tôi, có CORS, dùng cho làm nguyên mẫu và kiểm thử.

Dùng :name cho tham số, ví dụ /users/:id

Nội dung phản hồi
Độ trễ0 ms

Chuỗi như "{{fullName}}" hoặc "{{int(1, 100)}}" được thay thế ở mỗi yêu cầu.

mục

Nhập 0 để trả về một đối tượng duy nhất

Trình giữ chỗ (36)
{{id}}
1, 2, 3… vị trí trong danh sách
{{index}}
0, 1, 2… vị trí tính từ 0
{{uuid}}
UUID v4 ngẫu nhiên
{{firstName}}
Tên
{{lastName}}
Họ
{{fullName}}
Họ và tên
{{username}}
Tên người dùng viết thường
{{email}}
Địa chỉ email tại example.com
{{phone}}
Số điện thoại (+1 555…)
{{company}}
Tên công ty
{{jobTitle}}
Chức danh
{{street}}
Địa chỉ đường phố
{{city}}
Thành phố
{{country}}
Quốc gia
{{countryCode}}
Mã ISO 3166
{{zip}}
Mã bưu chính 5 chữ số
{{domain}}
tên miền ví dụ
{{url}}
URL https
{{ipv4}}
IPv4 thuộc dải dành cho tài liệu
{{color}}
Màu HEX
{{word}}
Một từ lorem
{{words}}
words(n): n từ lorem
{{sentence}}
Câu lorem
{{paragraph}}
Từ ba đến năm câu
{{int}}
int(min, max): số nguyên
{{float}}
float(min, max, decimals)
{{price}}
price(min, max): hai chữ số thập phân
{{bool}}
true hoặc false
{{date}}
Ngày trong năm qua (YYYY-MM-DD)
{{datetime}}
Ngày giờ ISO trong năm qua
{{futureDate}}
Ngày trong năm tới
{{status}}
active, pending hoặc inactive
{{pick}}
pick(a, b, c): một trong các lựa chọn
{{param}}
param(name): giá trị từ đường dẫn URL, ví dụ :id
{{query}}
query(name): giá trị từ chuỗi truy vấn
{{null}}
JSON null
Tiêu đề phản hồi (tùy chọn, chỉ X-)
3 / 10 endpoint · phản hồi JSON có bật CORS
Xử lý trên máy chủ của chúng tôi · endpoint JSON được lưu cho đến khi bạn xóa hoặc sau 7 ngày không có yêu cầu nàoCách hoạt động

Cách sử dụng Mock REST API

  1. 1

    Mô tả từng endpoint

    Chọn phương thức, nhập đường dẫn như /users/:id, rồi chọn mã trạng thái và độ trễ tùy ý để mô phỏng mạng chậm.

  2. 2

    Viết phản hồi

    Dán JSON cố định, hoặc chuyển sang Dữ liệu giả và viết mẫu JSON có các biến như {{fullName}} cùng số lượng mục trong danh sách.

  3. 3

    Tạo API giả lập

    Nhấn Tạo API giả lập để nhận URL gốc; mỗi endpoint trả lời tại URL đó cộng với đường dẫn của nó, đã bật CORS.

  4. 4

    Gọi thử và chỉnh sửa

    Dùng Thử, curl hoặc fetch từ ứng dụng của bạn, rồi sửa và lưu – thay đổi có hiệu lực ngay – hoặc xóa API giả lập khi dùng xong.

Giới hạn và Pro

Miễn phí: 10 endpoint cho mỗi API giả lập, 100 KB cho mỗi nội dung và tổng 512 KB, độ trễ tối đa 5 giây, danh sách tạo ra tối đa 100 mục, 120 yêu cầu mỗi phút cho mỗi người dùng, 10 API giả lập mới mỗi giờ, tự xóa sau 7 ngày không có yêu cầu.

Pro nâng giới hạn lên 50 endpoint, nội dung 1 MB, độ trễ 30 giây và danh sách 1.000 mục. Xem Pro

Về Mock REST API

Mock REST API giúp lập trình viên front-end và di động có endpoint hoạt động được trước khi back end thật ra đời. Mỗi API giả lập có URL gốc riêng dưới /api/mock-api/m/, và mọi endpoint bạn định nghĩa đều trả lời tại đó với phương thức, đường dẫn, mã trạng thái, độ trễ, header và nội dung JSON mà bạn đã chọn. Đường dẫn có thể chứa tham số, nên /users/:id khớp với /users/7, và mẫu có thể trả lại giá trị đó bằng {{param(id)}} hoặc đọc chuỗi truy vấn bằng {{query(name)}}.

Chế độ dữ liệu giả biến một mẫu JSON thành phản hồi trông như thật nhờ 36 biến, từ tên, email, công ty, thành phố đến UUID, ngày tháng, giá, số trong một khoảng và văn bản lorem. Đặt số lượng mục để trả về mảng tối đa 100 phần tử, và chọn dữ liệu giữ nguyên giữa các yêu cầu, phù hợp với snapshot test, hay thay đổi mỗi lần. Mã trạng thái từ 200 đến 599 cho phép bạn diễn tập các trạng thái lỗi như 401, 404, 429 và 503, còn độ trễ tối đa năm giây giúp xem trạng thái đang tải hoạt động ra sao.

Phản hồi luôn là JSON kèm header CORS, nên trình duyệt từ bất kỳ nguồn nào cũng gọi được. API giả lập không thể trả HTML, đặt cookie hay chuyển hướng, không lưu các yêu cầu nhận được và cũng không phải cơ sở dữ liệu: POST và PUT chỉ trả về nội dung bạn đã cấu hình mà không lưu bất cứ thứ gì được gửi lên.

Quyền riêng tư

Để lưu trữ endpoint của bạn, các định nghĩa bạn lưu – phương thức, đường dẫn, mã trạng thái, độ trễ, header và nội dung – được gửi đến và lưu trên máy chủ của chúng tôi, cùng với mã chỉnh sửa đã băm, thời điểm tạo và lần gọi gần nhất, và số lượng yêu cầu. Yêu cầu gửi đến endpoint được trả lời mà không ghi lại nội dung, header hay địa chỉ IP. API giả lập bị xóa khi bạn xóa, hoặc sau 7 ngày không có yêu cầu hay chỉnh sửa nào, còn mã chỉnh sửa chỉ được giữ trong trình duyệt này. Ai có URL đều gọi được endpoint của bạn, nên đừng đưa bí mật hay dữ liệu cá nhân thật vào.

Tính năng

Endpoint HTTPS thật

Mọi phương thức, tham số đường dẫn, mã trạng thái từ 200 đến 599, độ trễ và header X- tùy chỉnh.

Mẫu dữ liệu giả

Hơn 30 biến cho người, công ty, địa điểm, ngày tháng, số và văn bản, dưới dạng một đối tượng hoặc danh sách.

An toàn từ thiết kế

Chỉ JSON, bật CORS, không ghi nhật ký yêu cầu, mã chỉnh sửa được băm, tự xóa sau 7 ngày không dùng.

Mock REST API: câu hỏi thường gặp

Máy chủ lưu những gì và trong bao lâu?
Chúng tôi lưu các định nghĩa endpoint bạn đã lưu, mã băm SHA-256 của mã chỉnh sửa, thời điểm API giả lập được tạo và gọi lần cuối, cùng số yêu cầu đã nhận. Chúng tôi không ghi lại nội dung yêu cầu, header hay địa chỉ IP. Mỗi API giả lập bị xóa khi bạn nhấn Xóa, hoặc tự động sau 7 ngày không có yêu cầu hay chỉnh sửa nào, nên API bạn còn dùng sẽ luôn khả dụng.
Tôi có thể gọi API giả lập từ ứng dụng front-end không?
Có. Mọi phản hồi đều có Access-Control-Allow-Origin là *, và yêu cầu preflight OPTIONS cũng được trả lời, nên fetch, axios hay bất kỳ HTTP client nào trên trình duyệt, ở mọi tên miền kể cả localhost, đều gọi được. Hãy dùng URL gốc cộng với đường dẫn endpoint, ví dụ fetch(base + "/users"). Ứng dụng di động, Postman và curl cũng dùng được vì endpoint là URL HTTPS thông thường.
Các biến dữ liệu giả hoạt động thế nào?
Ở chế độ Dữ liệu giả, mọi chuỗi trong mẫu JSON là biến, như "{{email}}" hay "{{int(1, 100)}}", sẽ được thay thế khi có yêu cầu đến, và các biến số hoặc true hoặc false chiếm trọn cả chuỗi sẽ thành số và boolean thật trong JSON. Biến cũng có thể nằm trong văn bản, như "Hello {{firstName}}". Đặt số lượng mục để lặp lại mẫu, trong đó {{id}} đếm 1, 2, 3 cho từng mục.
API giả lập có thể trả lỗi hoặc phản hồi chậm không?
Có. Chọn bất kỳ trạng thái nào từ 200 đến 599, như 401 Unauthorized, 404 Not Found, 422 cho lỗi xác thực, 429 Too Many Requests hay 503, rồi viết JSON lỗi mà ứng dụng của bạn mong đợi. Độ trễ giữ mỗi phản hồi tối đa 5 giây ở gói miễn phí, giúp kiểm tra biểu tượng tải, timeout và logic thử lại. Phản hồi trạng thái 204 và 304 được gửi đi không có nội dung.
Vì sao API giả lập không thể trả HTML hoặc đặt cookie?
Endpoint lưu trữ miễn phí trả về nội dung tùy ý thường bị lợi dụng cho trang lừa đảo và liên kết mã độc. Để các API giả lập này chỉ dùng như API, mọi phản hồi đều là application/json kèm nosniff và chính sách bảo mật nội dung chặt chẽ, và chỉ cho phép header tùy chỉnh bắt đầu bằng X-, nên không thể đặt cookie, chuyển hướng trình duyệt hay giả làm trang web.