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. Tạo yêu cầu
  • 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. Tạo yêu cầu

Gỡ lỗi yêu cầu

Khi các yêu cầu API không hoạt động như mong đợi, Apidog cung cấp các công cụ gỡ lỗi mạnh mẽ để giúp bạn chẩn đoán và giải quyết sự cố nhanh chóng. Hướng dẫn này giải thích cách sử dụng Apidog Console để khắc phục sự cố và trình bày các vấn đề thường gặp cùng giải pháp tương ứng.

Yêu cầu thực tế#

Sau khi gửi một yêu cầu, bạn có thể chuyển sang tab Actual Request để xem đầy đủ chi tiết về những gì thực sự đã được gửi đến máy chủ, bao gồm URL yêu cầu, header và body.
Chế độ xem này đặc biệt hữu ích để xác minh rằng các biến, tham số và thông tin xác thực đã được phân giải chính xác trước khi yêu cầu được gửi đi.
Nếu tiếp tục cuộn xuống, bạn cũng có thể xem mã client để gửi yêu cầu này bằng nhiều ngôn ngữ lập trình khác nhau, giúp bạn triển khai cùng một yêu cầu trong ứng dụng của mình.

Gỡ lỗi trong Console#

Bạn có thể sử dụng console để xuất nhật ký bất cứ lúc nào trong quá trình thực thi yêu cầu, giúp bạn xác định vị trí sự cố trong các yêu cầu hoặc script của mình. Apidog hỗ trợ các phương thức console sau:
Việc trích xuất biến, thao tác cơ sở dữ liệu và các quy trình tự động khác sẽ tự động xuất kết quả của chúng ra console, cung cấp khả năng quan sát quá trình thực thi script.

Các vấn đề thường gặp#

Bảng sau đây trình bày các vấn đề thường gặp mà bạn có thể gặp khi gửi yêu cầu và giải pháp tương ứng:
Vấn đềGiải pháp
Kết nốiNếu Apidog không thể gửi yêu cầu của bạn, có thể đang xảy ra sự cố kết nối. Để kiểm tra, hãy thử mở một trang web trong trình duyệt web của bạn.
Tường lửaMột số tường lửa có thể được thiết lập để chặn các kết nối không đến từ trình duyệt. Trong trường hợp này, bạn cần liên hệ với quản trị viên mạng của mình để Apidog có thể hoạt động đúng cách.
Cài đặt proxyNếu bạn đang sử dụng máy chủ proxy để gửi yêu cầu, hãy xác minh cấu hình của bạn. Theo mặc định, Apidog sử dụng các cài đặt proxy được thiết lập trong cài đặt mạng của hệ điều hành. Apidog Console sẽ cung cấp chi tiết gỡ lỗi liên quan đến máy chủ proxy.
Chứng chỉ SSLBạn có thể gặp khó khăn với các kết nối HTTPS. Bạn có thể tắt xác minh chứng chỉ SSL trong Settings bằng cách nhấp vào biểu tượng cài đặt, sau đó điều hướng đến Settings > General. Nếu cách đó không giải quyết được vấn đề, máy chủ của bạn có thể đang sử dụng kết nối SSL phía client, có thể được cấu hình bằng cách nhấp vào biểu tượng cài đặt, sau đó đi tới Settings > Certificates. Hãy sử dụng Apidog Console để đảm bảo chứng chỉ SSL chính xác được gửi đến máy chủ. Tìm hiểu thêm về cách quản lý chứng chỉ.
Chứng chỉ clientChứng chỉ client có thể cần thiết cho máy chủ API của bạn. Bạn có thể thêm chứng chỉ client trong Settings bằng cách nhấp vào biểu tượng cài đặt, sau đó đi tới Settings > Certificates.
URL yêu cầu không chính xácNếu bạn đang sử dụng biến hoặc tham số đường dẫn trong yêu cầu của mình, hãy kiểm tra kỹ để bảo đảm địa chỉ cuối cùng là chính xác bằng cách kiểm tra Postman Console, nơi hiển thị URL mà yêu cầu của bạn đã được gửi đến khi thực thi. Các biến yêu cầu chưa được phân giải có thể dẫn đến địa chỉ máy chủ không chính xác.
Giao thức không chính xácĐảm bảo bạn đang sử dụng đúng giao thức (http:// hoặc https://) trong URL của mình.
Thời gian chờ ngắnNếu thời gian chờ ngắn được cấu hình trong Apidog, yêu cầu có thể hết thời gian chờ trước khi hoàn tất, dẫn đến lỗi. Để tránh điều này, hãy tăng Request timeout trong Settings bằng cách nhấp vào biểu tượng cài đặt, sau đó điều hướng đến Settings > General.
Phản hồi không hợp lệNếu máy chủ của bạn gửi phản hồi có lỗi mã hóa hoặc header không hợp lệ, Apidog có thể gặp khó khăn khi diễn giải chúng.
Phiên bản TLSApidog hỗ trợ TLS phiên bản 1.2 trở lên, có thể không tương thích với các trình duyệt hoặc hệ điều hành cũ hơn.
Lỗi ApidogCó thể Apidog đang gửi các yêu cầu không chính xác đến máy chủ API của bạn. Bạn có thể xác minh điều này bằng cách kiểm tra nhật ký máy chủ, nếu có thể truy cập. Nếu bạn nghi ngờ điều này đang xảy ra, hãy liên hệ với đội ngũ Apidog qua trình theo dõi issue trên GitHub.
Biến chưa được phân giảiMột biến chưa được phân giải là biến không được định nghĩa trong phạm vi khả dụng cho yêu cầu mà biến đó được sử dụng.
CORSNếu ứng dụng web Apidog gặp sự cố khi gửi yêu cầu của bạn, nguyên nhân có thể là lỗi chia sẻ tài nguyên giữa các nguồn gốc (CORS). Hãy đảm bảo bạn đang sử dụng Apidog Agent phù hợp cho yêu cầu của mình. Bạn cũng có thể sử dụng Apidog Client để tránh vấn đề CORS.
Đối với hầu hết các tình huống gỡ lỗi, tab Actual Request và Console cung cấp tất cả thông tin bạn cần để xác định và khắc phục sự cố với các yêu cầu API của mình.
Modified at 2026-06-11 10:23:06
Previous
Cài đặt yêu cầu
Next
Lưu yêu cầu dưới dạng Endpoint
Built with