Nhóm frontend của bạn đang bị tắc nghẽn. Thiết kế đã được duyệt, các màn hình đã được xây dựng một nửa, và điều duy nhất cản trở là một API chưa tồn tại. Phần backend vẫn còn một sprint nữa mới hoàn thành, nên giao diện người dùng không có gì thực để gọi. Giải pháp tạm thời thông thường là một mock cục bộ, và nó hoạt động tốt cho đến khi bạn đóng laptop. Sau đó, điểm cuối mà đồng đội của bạn ở múi giờ khác đang truy cập sẽ ngừng hoạt động.
Đó là khoảng trống mà Apidog lấp đầy với Cloud Mock. Thay vì một mock tồn tại và biến mất trên một máy tính, bạn nhận được một URL công khai được lưu trữ tại mock.apidog.com luôn hoạt động 24/7. Các nhà phát triển frontend, QA và đối tác đều có thể truy cập các điểm cuối thực tế trước khi một dòng mã backend nào được triển khai. Nếu bạn muốn có cái nhìn tổng quan hơn về lợi ích mà mocking mang lại cho một nhóm, bài giới thiệu của chúng tôi về mock API là gì và khi nào nên sử dụng sẽ đặt nền tảng. Để hiểu về cơ chế một URL mock công khai hoạt động trong việc xử lý yêu cầu, tài liệu tham khảo MDN về mô hình yêu cầu/phản hồi HTTP là một kiến thức củng cố vững chắc.
Cloud Mock là gì và tại sao các mock cục bộ không hiệu quả
Apidog tạo ra một điểm cuối mock cho mỗi API bạn thiết kế. Theo mặc định, mock đó là một mock cục bộ: nó chạy từ phiên bản Apidog của bạn và phản hồi khi máy tính của bạn đang bật. Khoảnh khắc bạn tắt máy, điểm cuối sẽ ngừng phản hồi. Điều đó tốt cho việc gỡ lỗi cá nhân. Nhưng nó sẽ đổ vỡ ngay lập tức khi người khác phụ thuộc vào URL đó.
Cloud Mock là giải pháp. Đó là một điểm cuối mock luôn khả dụng, tồn tại độc lập với bất kỳ máy cá nhân nào. Máy tính của đồng đội bạn có thể đang ngủ, laptop của bạn có thể nằm trong túi, và mock đám mây vẫn tiếp tục trả lời các yêu cầu 24/7. Điểm cuối này nằm trên dịch vụ lưu trữ của Apidog, vì vậy tính khả dụng không bị ràng buộc bởi việc ai đang trực tuyến.
Lợi ích thực tế là việc bàn giao rõ ràng. Bạn thiết kế hợp đồng, bật Cloud Mock và chia sẻ một URL. Frontend xây dựng dựa trên dữ liệu thực tế, QA viết các trường hợp kiểm thử dựa trên các cấu trúc phản hồi thực, và một đối tác tích hợp với bạn có thể bắt đầu kết nối máy khách của họ ngay lập tức. Không ai phải chờ đợi backend, và không ai phải chờ bạn duy trì một quy trình đang chạy. Nếu bạn đang điều phối việc này trên nhiều khu vực, các mẫu trong chia sẻ máy chủ mock và môi trường với các nhóm toàn cầu sẽ đi sâu hơn vào quy trình làm việc.
Kích hoạt Cloud Mock và nhận URL công khai của bạn
Hãy cùng xem xét một ví dụ API thực tế. Giả sử bạn đang xây dựng dịch vụ users với điểm cuối GET /users trả về danh sách hồ sơ khách hàng. Đây là cách bạn biến nó thành một điểm cuối đám mây có thể chia sẻ.
Bước 1: Bật Cloud Mock
Mở dự án của bạn và đi tới Cài đặt Dự án > Cài đặt Tính năng > Cài đặt Mock. Bật Cloud Mock. Đó là công tắc báo cho Apidog lưu trữ các mock của bạn trên dịch vụ luôn hoạt động của họ thay vì chỉ phục vụ cục bộ.
Bạn chỉ thực hiện thao tác này một lần cho mỗi dự án. Sau khi bật, mỗi điểm cuối trong dự án sẽ có một URL mock đám mây bên cạnh URL cục bộ của nó.
Bước 2: Sao chép URL mock đám mây
Mở điểm cuối bạn muốn chia sẻ, trong trường hợp này là GET /users. Vào tab Mock của nó và sao chép URL Cloud Mock. Bạn sẽ nhận được một cái gì đó có dạng như sau:
https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi
Cấu trúc đường dẫn tuân theo một mẫu: mock.apidog.com/m1/<projectId>-<num>-<env>/<path>. Apidog xây dựng nó cho bạn, vì vậy bạn không cần phải tự mình lắp ráp. Lưu ý rằng tài liệu chỉ hiển thị ví dụ thay vì công bố một mẫu cố định, vì vậy hãy coi URL đã sao chép là nguồn đáng tin cậy thay vì cố gắng tự tạo một URL.
Bước 3: Kiểm tra mock ngay lập tức trong Apidog
Trước khi bạn gửi URL cho bất kỳ ai, hãy xác nhận nó trả về những gì bạn mong đợi. Trên cùng tab Mock, gửi một yêu cầu kiểm tra đến URL mock. Apidog sẽ gửi yêu cầu và hiển thị phản hồi ngay tại đó. Bạn sẽ biết ngay liệu dữ liệu được tạo có chính xác hay không.
Một mock GET /users có thể trả về như sau:
[
{
"id": 1,
"name": "Amelia Turner",
"email": "amelia.turner@example.com",
"city": "Portland"
},
{
"id": 2,
"name": "Marcus Bell",
"email": "marcus.bell@example.com",
"city": "Austin"
}
]
Những giá trị đó không được mã hóa cứng. Apidog đọc tên và kiểu trường của schema của bạn và tạo dữ liệu hợp lý để khớp, điều này làm cho mock hữu ích cho một frontend hiển thị một bảng trông giống thật.
Bước 4: Mở URL trong trình duyệt
Đối với yêu cầu GET, URL mock đám mây hoạt động trực tiếp trong trình duyệt web. Dán nó vào thanh địa chỉ và bạn sẽ thấy phản hồi JSON. Đây là cách kiểm tra nhanh nhất mà bạn có thể đưa cho một bên liên quan không chuyên về kỹ thuật: không cần máy khách, không cần curl, chỉ cần một liên kết trả về dữ liệu.
Đối với bất cứ điều gì ngoài việc xem nhanh, frontend của bạn gọi nó giống như bất kỳ điểm cuối nào khác:
curl "https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"
Đó là toàn bộ quy trình. Thiết kế điểm cuối, bật Cloud Mock, sao chép URL, và nhóm của bạn đã được gỡ bỏ tắc nghẽn.
Bảo mật mock bằng xác thực token
Một URL công khai rất tiện lợi, và đôi khi quá tiện lợi. Nếu mock của bạn phản ánh một tính năng chưa phát hành hoặc một tích hợp đối tác mà bạn không muốn lộ ra, bạn có thể khóa nó lại.
Đi tới Cài đặt Dự án > Cài đặt Tính năng > Cài đặt Mock và đặt quyền truy cập thành Xác thực Token. Khi tính năng này được bật, mọi yêu cầu phải mang theo một apidogToken hợp lệ, và các yêu cầu không có token sẽ bị từ chối. Bạn có thể cung cấp token theo ba cách:
Là một tham số chuỗi truy vấn URL, điều mà URL đã sao chép đã sử dụng:
curl "https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"
Là một tiêu đề yêu cầu, điều này giữ token không nằm trong URL và không nằm trong nhật ký máy chủ:
curl "https://mock.apidog.com/m1/2689726-0-default/users" \
-H "apidogToken: GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"
Hoặc là một tham số trong phần thân được đặt tên apidogToken trong yêu cầu form-data hoặc x-www-form-urlencoded, phù hợp với các máy khách gửi dữ liệu biểu mẫu.
Đối với mã frontend, cách tiếp cận bằng tiêu đề thường là sạch nhất. Nó giữ token không nằm trong bất kỳ thứ gì ghi nhật ký URL đầy đủ và tách biệt thông tin xác thực khỏi đường dẫn tài nguyên:
const res = await fetch(
"https://mock.apidog.com/m1/2689726-0-default/users",
{ headers: { apidogToken: "GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi" } }
);
const users = await res.json();
Một điều cần lưu ý: nếu bạn bật Xác thực Token sau khi đã chia sẻ một URL thuần túy, mọi người dùng cần thêm token hoặc các cuộc gọi của họ sẽ bắt đầu thất bại. Hãy phối hợp việc chuyển đổi để QA và đối tác không phải đối mặt với các yêu cầu bị từ chối.
Tạo dữ liệu thực tế, theo khu vực với các ngôn ngữ địa phương (locales)
Một mock trả về "name": "string" cho mỗi bản ghi không dạy được gì cho giao diện người dùng của bạn. Một mock trả về tên, địa chỉ và số điện thoại trông thật cho phép frontend phát hiện các lỗi bố cục, tràn văn bản và các vấn đề định dạng trước khi dữ liệu thực sự đến. Apidog xử lý điều này bằng Faker.js bên trong, và các điều khiển locale là nơi nó thực sự hữu ích cho các sản phẩm quốc tế.
Cách hoạt động của ngôn ngữ địa phương mặc định
Theo mặc định, Faker tuân theo cài đặt ngôn ngữ của dự án của bạn. Điều đó được cấu hình trong **Cài đặt Dự án > Cài đặt Cơ bản**, và bất kỳ ngôn ngữ nào bạn chọn ở đó sẽ trở thành ngôn ngữ địa phương mặc định cho tất cả các giá trị mock được tạo. Đặt dự án thành tiếng Pháp và tên và địa chỉ mock của bạn sẽ trả về theo phong cách Pháp mà không cần thao tác riêng cho từng trường.
Ghi đè ngôn ngữ địa phương cho toàn bộ dự án
Nếu bạn muốn dữ liệu mock bằng một ngôn ngữ địa phương cụ thể khác với ngôn ngữ dự án, bạn có thể ghi đè nó. Đi tới **Cài đặt Dự án > Cài đặt Tính năng > Cài đặt Mock** và chọn một ngôn ngữ địa phương của Faker từ menu thả xuống. Quyết định ghi đè đó sẽ được ưu tiên hơn cài đặt ngôn ngữ mặc định của Cài đặt Cơ bản cho mọi trường trong dự án.
Điều này rất tiện lợi khi bạn đang kiểm thử quốc tế hóa. Đặt ngôn ngữ địa phương của dự án thành Nhật Bản và mọi địa chỉ, tên, và số điện thoại được tạo sẽ phản ánh khu vực đó, vì vậy bạn có thể thấy giao diện người dùng của mình hoạt động như thế nào với các script không phải Latinh và các định dạng địa chỉ khác nhau. Tự động tạo loại dữ liệu nhận biết schema này là một chủ đề riêng, và hướng dẫn về mock thông minh của Apidog và cách nó đọc schema của bạn bao gồm chi tiết về mặt tạo dữ liệu.
Ghi đè ngôn ngữ địa phương theo từng trường
Đôi khi bạn cần một trường có ngôn ngữ địa phương khác với phần còn lại, ví dụ như một danh sách khách hàng kết hợp nhiều khu vực. Bạn có thể đặt ngôn ngữ địa phương ngay trong biểu thức mock bằng cách sử dụng `locale parameter`:
{{$person.fullName(locale='ja')}}
Điều đó xuất ra tên tiếng Nhật như 田中 太郎 chỉ cho trường đó, trong khi phần còn lại của phản hồi tuân theo ngôn ngữ địa phương của dự án. Thứ tự ưu tiên chạy theo ba cấp độ: ngôn ngữ địa phương cấp trường ghi đè ngôn ngữ địa phương cấp dự án, ngôn ngữ địa phương cấp dự án ghi đè ngôn ngữ mặc định của Cài đặt Cơ bản. Vì vậy, bạn đặt một mặc định dự án hợp lý và chỉ sử dụng ghi đè cấp trường khi bạn thực sự cần ngoại lệ.
Một lưu ý nhanh về phạm vi: tài liệu hiển thị ja như một ví dụ đã thực hiện và không công bố danh sách đầy đủ các ngôn ngữ địa phương được hỗ trợ, vì vậy hãy xác nhận mã chính xác cho khu vực mục tiêu của bạn trong tài liệu mock của Apidog trước khi bạn dựa vào nó. Các quy ước riêng của Faker được ghi trong tài liệu tham khảo ngôn ngữ địa phương của Faker.js.
Đồng bộ múi giờ nữa
Có một điều khiển song song cho thời gian. Một mặc định cấp dự án nằm trong **Cài đặt Dự án > Cài đặt Tính năng > Cài đặt Mock**, và bạn có thể ghi đè cho từng trường bằng `tham số timeZone` bên trong một biểu thức mock. Nếu giao diện người dùng của bạn hiển thị dấu thời gian, điều này giữ cho các giá trị `createdAt` được tạo ra phù hợp với khu vực bạn đang mô phỏng thay vì mặc định theo nơi máy chủ của bạn đặt.
Với các điều khiển ngôn ngữ địa phương và múi giờ, bạn có thể thiết lập một mock mô phỏng một cách thuyết phục cơ sở người dùng Nhật Bản, Đức, hoặc một nhóm quốc tế hỗn hợp, tất cả từ cùng một schema điểm cuối. Để biết thêm các kịch bản mà điều này mở ra, tổng hợp về các trường hợp sử dụng mock API thực tế rất đáng để xem xét.
Cloud Mock so với mock tự lưu trữ
Cloud Mock là tùy chọn lưu trữ của Apidog, và nó phù hợp với hầu hết các nhóm. Nếu tổ chức của bạn có các quy tắc về lưu trú dữ liệu hoặc chính sách cấm định tuyến lưu lượng kiểm thử qua đám mây của nhà cung cấp, Apidog cũng hỗ trợ chạy dịch vụ mock trên cơ sở hạ tầng của riêng bạn. Sự đánh đổi rất rõ ràng: tùy chọn đám mây không cần cài đặt và luôn hoạt động, trong khi tự lưu trữ mang lại cho bạn quyền kiểm soát với chi phí tự chạy dịch vụ. Nếu đó là tình huống của bạn, hướng dẫn tự lưu trữ máy chủ mock Apidog sẽ hướng dẫn bạn. Đối với các nhóm đang cân nhắc các tùy chọn lưu trữ song song, so sánh các công cụ mock API trực tuyến sẽ trình bày bức tranh tổng thể.
Về việc giới hạn gói, một câu trả lời thẳng thắn: các tính năng Cloud Mock và locale được ghi lại ở đây không nêu rõ yêu cầu gói cụ thể, vì vậy cách trung thực là kiểm tra tính khả dụng hiện tại trong tài khoản của riêng bạn thay vì lấy một con số từ bài đăng trên blog. Bạn có thể Tải xuống Apidog và thử toàn bộ quy trình để xem chính xác những gì không gian làm việc của bạn bao gồm.
Tự động hóa quy trình làm việc với Apidog CLI
Mocking trong Apidog là một khả năng GUI và đám mây. Các phản hồi mock được tạo tự động từ schema điểm cuối của bạn và được phục vụ bởi engine lưu trữ của Apidog, chứ không phải bởi bất kỳ thứ gì bạn chạy trong terminal. Vì vậy, cách trình bày trung thực là: Apidog CLI không khởi động hoặc phục vụ máy chủ mock. Điều nó làm là giữ cho các đầu vào của mock của bạn chính xác.
CLI và các tác nhân mã hóa AI như Cursor hoặc Claude Code có thể tạo và cập nhật các điểm cuối và schema trong dự án của bạn. Bởi vì mock đám mây đọc các schema đó để tạo dữ liệu, việc giữ cho đặc tả hiện hành giúp đầu ra mock chính xác khi API phát triển. Khi bạn sử dụng một công cụ tác nhân để thêm một trường, mock sẽ phản ánh điều đó mà không cần chỉnh sửa thủ công.
Sau đó, một khi mock đã gỡ bỏ tắc nghẽn công việc frontend và backend thực sự được triển khai, các kịch bản kiểm thử của cùng dự án sẽ chạy không giao diện với nó. Lệnh thực thi của CLI xác thực backend trực tiếp dựa trên cùng một hợp đồng mà mock đã mô tả:
apidog run -t <scenario_id> -e <env_id> -r cli
Lệnh đơn đó chạy một kịch bản kiểm thử đã lưu với một môi trường và báo cáo kết quả, vì vậy mock đã gỡ bỏ tắc nghẽn giao diện người dùng và các kiểm thử xác minh backend đều truy về một nguồn chân lý duy nhất. Mở kịch bản của bạn trong Apidog và sao chép lệnh được tạo với ID kịch bản `-t` và ID môi trường `-e` đã được điền sẵn, thay vì tự lắp ráp các cờ. Việc kết nối điều đó vào một pipeline được đề cập trong hướng dẫn chạy Apidog trong pipeline CI/CD.
Câu hỏi thường gặp
URL mock đám mây có tiếp tục hoạt động khi tôi đóng Apidog không?
Có, đó là toàn bộ mục đích của Cloud Mock. Không giống như mock cục bộ, nơi ngừng phản hồi khi máy chủ đóng, mock đám mây được phục vụ từ cơ sở hạ tầng của Apidog và luôn khả dụng 24/7. Đồng đội của bạn có thể truy cập nó bất kể máy tính của bạn có đang bật hay không.
Tôi có thể sử dụng URL mock đám mây trực tiếp trong trình duyệt không?
Đối với các yêu cầu GET, có. Dán URL đầy đủ, bao gồm tham số truy vấn apidogToken, vào thanh địa chỉ của bạn và bạn sẽ thấy phản hồi JSON. Đối với các phương thức khác hoặc để giữ token không nằm trong lịch sử URL của bạn, hãy gọi nó bằng một công cụ như curl hoặc máy khách frontend của bạn và truyền token dưới dạng một tiêu đề thay thế.
Điều gì xảy ra với các yêu cầu không bao gồm token?
Nếu bạn đã đặt quyền truy cập thành Xác thực Token, bất kỳ yêu cầu nào không có apidogToken hợp lệ sẽ bị từ chối. Cung cấp nó dưới dạng tham số chuỗi truy vấn, tiêu đề yêu cầu hoặc tham số phần thân trong yêu cầu biểu mẫu. Nếu bạn bật xác thực token sau khi chia sẻ một URL thuần túy, hãy thông báo cho người dùng của bạn để họ có thể thêm token trước khi các cuộc gọi của họ bắt đầu thất bại.
Làm cách nào để lấy dữ liệu mock phù hợp với một quốc gia cụ thể?
Đặt ngôn ngữ địa phương của dự án trong Cài đặt Cơ bản, hoặc ghi đè nó cho toàn bộ dự án trong Cài đặt Tính năng > Cài đặt Mock, hoặc ghi đè một trường duy nhất bằng tham số `locale` trong biểu thức mock, ví dụ: {{$person.fullName(locale='ja')}}. Cấp trường sẽ ưu tiên hơn cấp dự án, và cấp dự án ưu tiên hơn mặc định của Cài đặt Cơ bản. Hướng dẫn mock thông minh cho thấy cách tạo dữ liệu nhận biết schema liên quan đến điều này.
Tôi nên sử dụng Cloud Mock hay một công cụ mock không giao diện?
Cloud Mock phù hợp với các nhóm muốn một điểm cuối được lưu trữ, không cần bảo trì, gắn liền với thiết kế API của họ. Nếu bạn cần các mock được nhúng vào một bản dựng tự động mà không có giao diện người dùng nào, khảo sát về công cụ mock không giao diện so sánh các tùy chọn và nơi mỗi tùy chọn phù hợp. Đặc tả OpenAPI Initiative là nền tảng cho hầu hết các công cụ này, vì vậy một đặc tả sạch sẽ mang lại lợi ích bất kể bạn chọn con đường nào.
Tóm tắt
Một mock chỉ tồn tại trên laptop của bạn chỉ gỡ bỏ tắc nghẽn cho một người. Cloud Mock biến nó thành một URL công khai mock.apidog.com mà toàn bộ nhóm của bạn có thể xây dựng dựa trên, với xác thực token khi bạn cần bảo vệ nó và các điều khiển ngôn ngữ địa phương khi dữ liệu của bạn cần trông thực tế cho một khu vực cụ thể. Thiết kế điểm cuối, bật công tắc, chia sẻ liên kết, và frontend ngừng chờ đợi backend. Tải xuống Apidog để thiết lập mock đám mây có thể chia sẻ đầu tiên của bạn, miễn phí và không yêu cầu thẻ tín dụng.