Apidog Docs
🇻🇳 Tiếng Việt
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇻🇳 Tiếng Việt
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇻🇳 Tiếng Việt
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. Phát triển và gỡ lỗi API
  • Trung tâm Học tập Apidog
  • Bắt đầu
    • Giới thiệu về Apidog
    • Các khái niệm cơ bản trong Apidog
    • Điều hướng Apidog
    • Bắt đầu nhanh
      • Tổng quan
      • Tạo một Endpoint
      • Tạo yêu cầu
      • Thêm một khẳng định
      • Tạo kịch bản kiểm thử
      • Chia sẻ tài liệu API
      • Khám phá thêm
    • Di chuyển sang Apidog
      • Tổng quan
      • Nhập thủ công
      • Nhập theo lịch (Liên kết nguồn dữ liệu)
      • Tùy chọn nhập
      • Xuất dữ liệu
      • Nhập từ
        • Nhập từ Postman
        • Nhập OpenAPI Spec
        • Nhập cURL
        • Nhập Markdown
        • Nhập từ Insomnia
        • Nhập từ apiDoc
        • Nhập tệp .har
        • Nhập WSDL
  • Dữ liệu API mock
    • Tổng quan
    • Smart Mock
    • Mock tùy chỉnh
    • Trình tự ưu tiên Mock
    • Mock Scripts
    • Cloud Mock
    • Self-Hosted Runner Mock
    • Ngôn ngữ Mock (Locales)
  • Tài khoản và tùy chọn
    • Cài đặt tài khoản
    • Tạo Token truy cập OpenAPI
    • Thông báo
    • Cài đặt ngôn ngữ
    • Phím tắt
    • Cấu hình Proxy Mạng
    • Sao lưu dữ liệu
    • Cập nhật Apidog
    • Xóa tài khoản
    • Tính năng thử nghiệm
  • Gửi yêu cầu
    • Tổng quan
    • Gỡ lỗi SSE
    • MCP Client
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP hoặc WebService
    • GraphQL
    • gRPC
    • Sử dụng Tác nhân Proxy Yêu cầu để Gỡ lỗi
    • Tạo yêu cầu
      • Lịch sử yêu cầu
      • Cơ bản về yêu cầu
      • Tham số và Body
      • Header của yêu cầu
      • Cài đặt yêu cầu
      • Gỡ lỗi yêu cầu
      • Lưu yêu cầu dưới dạng Endpoint
      • HTTP/2
    • Xác thực và phân quyền
      • Tổng quan
      • Chứng chỉ CA và Chứng chỉ Client
      • Các loại ủy quyền
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Xác thực Hawk
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • Phản hồi và cookie
      • Xem phản hồi API
      • Quản lý Cookie
      • Tổng quan
  • Phát triển và gỡ lỗi API
    • Tổng quan
    • Tạo yêu cầu
    • Gửi yêu cầu
    • Trường hợp gỡ lỗi
    • Trường hợp kiểm thử
    • Giá trị động
    • Xác thực phản hồi
    • Design-First vs Request-First
    • Tạo mã
    • Môi trường và biến
      • Tổng quan
      • Sử dụng biến
      • Quản lý môi trường
    • Bí mật trong vault
      • Tổng quan
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • Mô-đun giá trị động
      • Hãng hàng không
      • Animal
      • Màu sắc
      • Commerce
      • Company
      • Cơ sở dữ liệu
      • Kiểu dữ liệu
      • Ngày
      • Finance
      • Food
      • Git
      • Hacker
      • Helpers
      • Hình ảnh
      • Internet
      • Vị trí
      • Lorem
      • Music
      • Number
      • Person
      • Phone
      • Science
      • String
      • Hệ thống
      • Vehicle
      • Từ
    • Bộ xử lý trước và sau
      • Tổng quan
      • Khẳng định
      • Trích xuất biến
      • Chờ
      • Bảo mật
      • Thao tác cơ sở dữ liệu
        • Tổng quan
        • MySQL
        • MongoDB
        • Redis
        • Oracle Client
      • Sử dụng script
        • Tổng quan
        • Script tiền xử lý
        • Tập lệnh hậu xử lý
        • Public Scripts
        • Tài liệu tham khảo về Postman Scripts
        • Gọi các ngôn ngữ lập trình khác
        • Sử dụng thư viện JS
        • Trực quan hóa phản hồi
        • Ví dụ script
          • Tập lệnh khẳng định
          • Sử dụng biến
          • Sửa đổi yêu cầu
          • Các ví dụ khác
    • Gỡ lỗi API
      • AI Agent Debugger
      • A2A Debugger
  • Thiết kế API
    • Tổng quan
    • Tạo một dự án API mới
    • Kiến thức cơ bản về Endpoint
    • Hướng dẫn thiết kế API
    • Mô-đun
    • Cấu hình nhiều ví dụ về body của yêu cầu
    • Thành phần
    • Trường Chung
    • Tham số toàn cục
    • Lịch sử thay đổi endpoint
    • Bình luận
    • Quản lý Endpoint Hàng loạt
    • Custom Protocol API
    • Chế độ Spec-first (Beta)
    • Lược đồ bảo mật
      • Tổng quan
      • Tạo Security Scheme
      • Sử dụng Lược đồ bảo mật
      • Lược đồ bảo mật trong tài liệu trực tuyến
    • Tính năng nâng cao
      • Trường Endpoint Tùy chỉnh
      • Các kịch bản kiểm thử được liên kết
      • Trạng thái Endpoint
      • Giao diện của Danh sách Tham số
      • Nhận dạng duy nhất endpoint
    • Schemas
      • Tổng quan
      • Tạo Schema Mới
      • Xây dựng Schema
      • Tạo Schema từ JSON, v.v.
      • oneOf, allOf, anyOf
      • Sử dụng Discriminator
  • Kiểm thử API
    • Tổng quan
    • Kịch bản kiểm thử
      • Tạo một kịch bản kiểm thử
      • Truyền dữ liệu giữa các yêu cầu
      • Điều kiện điều khiển luồng
      • Đồng bộ dữ liệu từ endpoint và trường hợp endpoint
      • Nhập Endpoint và Endpoint Case từ các dự án khác
      • Xuất Kịch bản Kiểm thử
    • Báo cáo kiểm thử
      • Báo cáo kiểm thử
    • Chạy kịch bản kiểm thử
      • Chạy một kịch bản kiểm thử
      • Chạy hàng loạt các kịch bản kiểm thử
      • Kiểm thử dựa trên dữ liệu
      • Dữ liệu kiểm thử dùng chung
      • Tác vụ đã lên lịch
      • Quản lý môi trường runtime của API từ các dự án khác
    • Bộ kiểm thử
      • Tổng quan
      • Tạo một bộ kiểm thử
      • Điều phối Bộ kiểm thử
      • Chạy bộ kiểm thử cục bộ
      • Chạy Bộ Kiểm Thử Qua CLI
      • Tác vụ đã lên lịch
    • Kiểm thử API
      • Kiểm thử tích hợp
      • Kiểm thử hiệu năng
      • Kiểm thử End-to-End
      • Kiểm thử hồi quy
      • Kiểm thử hợp đồng
    • Apidog CLI
      • Tổng quan
      • Cài đặt và chạy Apidog CLI
      • Tùy chọn Apidog CLI
    • CI/CD
      • Tổng quan
      • Tích hợp với Github Actions
      • Tích hợp với Gitlab
      • Tích hợp với Jenkins
      • Kích hoạt kiểm thử bằng Git Commit
  • Xuất bản tài liệu API
    • Tổng quan
    • Các công nghệ API được hỗ trợ
    • Chia sẻ nhanh
    • Xem tài liệu API
    • Tài liệu Markdown
    • Xuất bản site tài liệu
    • Trang đăng nhập tùy chỉnh
    • Bố cục tùy chỉnh
    • CSS, JavaScript, HTML tùy chỉnh
    • Tên miền tùy chỉnh
    • Tính năng AI
    • Cài đặt SEO
    • Cài đặt nâng cao
      • Tìm kiếm tài liệu
      • Proxy CORS
      • Tích hợp Google Analytics
      • Cài đặt cây thư mục
      • Cài đặt khả năng hiển thị
      • Nhúng giá trị vào URL tài liệu
    • Phiên bản API
      • Tổng quan
      • Tạo phiên bản API
      • Xuất bản các phiên bản API
      • Chia sẻ endpoint theo phiên bản API
  • Nhánh
    • Tổng quan
    • Tạo một Sprint Branch
    • Kiểm thử API trong một nhánh
    • Thiết kế API trong một nhánh
    • Hợp nhất các nhánh Sprint
    • Quản lý Nhánh Sprint
    • AI Branch (Beta)
  • Tính năng AI
    • Tổng quan
    • Bật các tính năng AI
    • Tạo Trường hợp Kiểm thử
    • Sửa đổi Schema bằng AI
    • Kiểm tra tuân thủ endpoint
    • Kiểm tra mức độ hoàn chỉnh của tài liệu API
    • Đặt tên trường bằng AI
    • Câu hỏi thường gặp
  • Máy chủ MCP Apidog
    • Tổng quan
    • Kết nối dự án Apidog với AI
    • Kết nối tài liệu đã xuất bản với AI
    • Kết nối tệp OpenAPI với AI
  • Thực hành tốt nhất
    • Xử lý chữ ký API
    • Truy cập các API được bảo vệ bằng OAuth 2.0
    • Quy trình cộng tác
    • Quản lý trạng thái xác thực
  • Không gian ngoại tuyến
    • Tổng quan
  • Apidog Europe
    • Apidog Europe
  • Quản trị
    • Quản lý dự án
      • Quản lý dự án
      • Cài đặt thông báo
      • Quản lý thành viên dự án
      • Tài nguyên dự án
        • Kết nối cơ sở dữ liệu
        • Kết nối Git
    • Quản lý nhóm
      • Quản lý nhóm
      • Quản lý thành viên nhóm
      • Hoạt động của nhóm
      • Vai trò & Quyền của Nhóm
      • Tài nguyên nhóm
        • General Runner
        • Biến nhóm
        • Request Proxy Agent
      • Cộng tác thời gian thực
        • Cộng tác nhóm
    • Danh sách kiểm tra onboarding
      • Khái niệm cơ bản
      • Hướng dẫn nhập môn
    • Quản lý tổ chức
      • Quản lý Tổ chức
      • Vai trò & Quyền trong Tổ chức
      • Quản lý gói
        • Người quản lý thanh toán trong tổ chức
      • Đăng nhập một lần (SSO)
        • Tổng quan về SSO
        • Cấu hình Microsoft Entra ID
        • Cấu hình Okta
        • Cấu hình SSO cho một tổ chức
        • Quản lý tài khoản người dùng
        • Ánh xạ Nhóm tới Đội
      • Cấp phát SCIM
        • Giới thiệu về cấp phát SCIM
        • Microsoft Entra ID
        • Okta
      • Tài nguyên tổ chức
        • Self-Hosted Runner
  • Thanh toán
    • Tổng quan
    • Credits
    • Nâng cấp gói của bạn
    • Phương thức thanh toán thay thế
    • Quản lý đăng ký
    • Chuyển các nhóm trả phí vào tổ chức
  • Tiện ích bổ sung
    • API Hub
    • Apidog Intellij IDEA Plugin
    • Tiện ích mở rộng trình duyệt
      • Chrome
      • Microsoft Edge
    • Proxy yêu cầu
      • Proxy yêu cầu trên Web
      • Proxy yêu cầu trong tài liệu được chia sẻ
      • Proxy yêu cầu trong Client
  • Dữ liệu và bảo mật
    • Lưu trữ và bảo mật dữ liệu
    • Quyền riêng tư và bảo mật dữ liệu người dùng
    • Định tuyến yêu cầu và bảo mật dữ liệu
  • Tham chiếu
    • Phương pháp tiếp cận API Design-First
    • Phần mở rộng Đặc tả OpenAPI của Apidog
    • JSONPath
    • XPath
    • Biểu thức chính quy
    • JSON Schema
    • Định dạng tệp CSV
    • Cài đặt môi trường Java
    • Môi trường triển khai Runner
    • Cú pháp Markdown của Apidog
    • Tiện ích mở rộng Swagger của Apidog
      • Tổng quan
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Tiện ích mở rộng JSON Schema của Apidog
      • Tổng quan
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • Trung tâm hỗ trợ
  1. Phát triển và gỡ lỗi API

Tạo yêu cầu

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#

Chế độ Design-first
Chế độ Request-first
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.
Ví dụ tham số 1
Ví dụ tham số 2
TIP
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#

Chế độ Design-first
Chế độ Request-first
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.
Ví dụ tự động tạo body yêu cầu

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:
Tùy chọn tự động tạo dữ liệu

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#

Tính năng: Tạo lại dữ liệu theo quy tắc smart mock mỗi khi một yêu cầu được gửi.
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.
Tạo mỗi lần

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.
Tùy chọn ưu tiên tự động tạo
Ư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.
Giá trị ví dụ của trường
Ưu tiên dùng giá trị mặc định
Tí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.
Giá trị mặc định của trường
Dùng giá trị Mock
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.
Chỉ tạo tên trường
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.
Dùng ví dụ yêu cầu
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.
TIP
Tìm hiểu thêm về Giá trị động.

Gửi yêu cầu#

Nhấp vào Send để gửi yêu cầu.
TIP
Tìm hiểu thêm về Gửi yêu cầu.
Modified at 2026-06-11 10:23:06
Previous
Tổng quan
Next
Gửi yêu cầu
Built with