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. Xuất bản tài liệu 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. Xuất bản tài liệu API

CSS, JavaScript, HTML tùy chỉnh

Khi xuất bản tài liệu API, bạn có thể thêm HTML, CSS và JavaScript toàn cục tùy chỉnh để cá nhân hóa kiểu trang và mở rộng chức năng.
Tính năng này hữu ích cho:
Nhúng các dịch vụ bên thứ ba (ví dụ: chatbot, trợ lý AI)
Sửa đổi kiểu mặc định (ví dụ: phông chữ, màu sắc, nền)
Thêm các phần tử tương tác (ví dụ: nút, popup, phản hồi nhanh)
Bằng cách sử dụng tính năng này một cách hợp lý, tài liệu của bạn có thể phản ánh tốt hơn bản sắc thương hiệu và cải thiện trải nghiệm người dùng.

CSS#

Với CSS tùy chỉnh, bạn có thể thay đổi phông chữ, ẩn phần tử, điều chỉnh lề, thay đổi màu sắc, v.v.
Vì cấu trúc tài liệu có thể thay đổi trong các bản cập nhật tương lai, chúng tôi khuyến nghị tuân theo hai nguyên tắc sau để bảo đảm các kiểu của bạn vẫn hiệu quả:
1.
Sử dụng các biến CSS được dành riêng
2.
Sử dụng các tên lớp CSS được dành riêng

Sử dụng các biến CSS được dành riêng#

Apidog cung cấp một tập hợp các biến CSS có tiền tố --g- để kiểm soát các kiểu trang cơ bản như phông chữ, màu sắc và nền. Các biến này thích ứng tốt với cả chế độ sáng và tối, giúp kiểu của bạn ổn định và dễ bảo trì hơn.
Tham chiếu các biến thông dụng
Ví dụ: Thay đổi màu văn bản chính

Sử dụng các tên lớp CSS được dành riêng#

Để nhắm mục tiêu các khu vực cụ thể nhằm định kiểu, hãy sử dụng các tên lớp được Apidog dành riêng với tiền tố .g-. Các tên lớp này tương đối ổn định và ít có khả năng bị hỏng do thay đổi DOM.
Tham chiếu các lớp CSS thông dụng
Ví dụ: Ẩn thanh bên trái

Kiểm tra cấu trúc trang và tên lớp#

Ngoài các biến CSS và tên lớp được dành riêng đã nêu ở trên, bạn cũng có thể sử dụng công cụ dành cho nhà phát triển của trình duyệt để tìm tên lớp tương ứng với phần tử trang mà bạn muốn sửa đổi, sau đó viết CSS để điều chỉnh kiểu.
Khuyến nghị ưu tiên sử dụng các tên lớp bắt đầu bằng .g-. Các tên này được nền tảng dành riêng, có cấu trúc tương đối ổn định và không dễ bị lỗi. Đối với các tên lớp cấu trúc khác, vui lòng sử dụng thận trọng để tránh lỗi kiểu sau khi nâng cấp sản phẩm.
Bạn có thể mở site tài liệu đã xuất bản trong trình duyệt và sử dụng công cụ dành cho nhà phát triển (chế độ nhà phát triển/console) để xem cấu trúc trang và tên lớp kiểu:
Mac: Command + Option + Ihoặcfn + F12
Windows: Ctrl + Shift + Ihoặcfn + F12hoặcF12
Sau khi mở, hãy nhấp vào "Element Selector" (biểu tượng con trỏ chuột), sau đó nhấp vào bất kỳ khu vực nào trên trang để xem các thẻ HTML và tên lớp tương ứng với khu vực đó.
Bạn cũng có thể sử dụng chức năng tìm kiếm (Cmd/Ctrl + F) để định vị một tên lớp.
image.png

JavaScript#

JavaScript tùy chỉnh được dùng để nhúng các dịch vụ bên thứ ba như trợ lý AI hoặc tiện ích hỗ trợ. Lưu ý: Trường JavaScript tùy chỉnh của Apidog không hỗ trợ thẻ <script> hoặc <style>. Bạn phải chuyển đổi chúng thành JavaScript thuần. Ví dụ:
❌ Bản gốc (không được hỗ trợ)
✅ Đã chuyển đổi sang JavaScript thuần
Nếu bạn muốn nhúng một script hoặc style của bên thứ ba nhưng không chắc cách viết lại thành định dạng JS thuần, bạn có thể sao chép prompt bên dưới và dán vào một công cụ AI (chẳng hạn như Claude) để AI giúp bạn tự động chuyển đổi:
I'm using Apidog's "Custom JavaScript" feature, which only allows pure JavaScript (no <script> or <style> tags).

Please convert the following code to pure JavaScript. Here are the requirements:
1. Rewrite the <script> tag to document.createElement('script') dynamic creation method;
2. Inject the <style> content into the newly created style tag and insert the head;
3. Please use standard methods (such as createElement, appendChild) for all DOM operations, and do not use document.write;
4. If the original code uses `window.addEventListener('DOMContentLoaded', ...)` or `window.addEventListener('load', ...)` only to wait for the page before running code, remove the event listener and run the code directly. Apidog executes custom JavaScript after the documentation page has been rendered, so the browser's `load` event may already have passed by that time; code registered inside a `load` listener may not be executed;
5. The final generated JavaScript should be able to run directly in the browser without any explanation.

Original code:
---
(paste your code here)
---
Vì lý do bảo mật, JavaScript tùy chỉnh chỉ hoạt động khi truy cập tài liệu qua tên miền tùy chỉnh.
Nếu bạn truy cập thông qua địa chỉ tài liệu mặc định do Apidog cung cấp (chẳng hạn như bắt đầu bằng https://xxx.apidog.io/), JS tùy chỉnh sẽ không được tải và thực thi.
Vui lòng bảo đảm rằng bản thân mã là đáng tin cậy để tránh ảnh hưởng đến việc tải bình thường hoặc phá hủy cấu trúc trang.
JavaScript tùy chỉnh được thực thi sau khi trang tài liệu đã được render. Vì sự kiện load của trình duyệt có thể đã xảy ra vào thời điểm đó, mã đặt bên trong window.addEventListener('load', ...) có thể không chạy. Trong hầu hết trường hợp, hãy chạy mã của bạn trực tiếp thay vào đó:

Ví dụ: Hộp có thể mở rộng/thu gọn#

Nhấp vào nút bên dưới để mở rộng/thu gọn hộp thoại iframe
Script cho "Nhấp vào nút để mở rộng/thu gọn hộp thoại iframe"
Cách sử dụng:
1
Dán mã vào khu vực "Custom JavaScript" của Apidog.
2
Truy cập các site tài liệu qua tên miền tùy chỉnh của bạn
3
Một nút xuất hiện ở góc dưới bên phải; nhấp để mở iframe trò chuyện.
4
Thay iframe.src bằng dịch vụ AI của bạn, ví dụ:
CSS và JavaScript tùy chỉnh

Ví dụ: Nhúng tiện ích Chatbase#

Script cho "Nhúng tiện ích trò chuyện Chatbase"
Cách sử dụng:
1
Tạo một ứng dụng Chatbase, lấy mã nhúng, chuyển đổi mã đó sang JS thuần bằng prompt ở trên.
image.png
Dán mã đã chuyển đổi vào phần Custom JS của Apidog.
2
Truy cập các site tài liệu qua tên miền tùy chỉnh của bạn.
3
Một nút sẽ xuất hiện ở góc dưới bên phải. Nhấp vào nút đó để mở một cửa sổ hộp thoại.
CSS và JavaScript tùy chỉnh

HTML#

Tính năng HTML hiện đang được phát triển. Vui lòng chờ bản phát hành.

Câu hỏi thường gặp#

Custom JS không hoạt động?
Hãy bảo đảm rằng bạn đang truy cập tài liệu qua tên miền tùy chỉnh. JavaScript tùy chỉnh chỉ được thực thi khi sử dụng tên miền tùy chỉnh đã được liên kết.
Tôi có nên sử dụng 'load' hoặc 'DOMContentLoaded' trong JavaScript tùy chỉnh không?
Modified at 2026-06-11 10:23:06
Previous
Bố cục tùy chỉnh
Next
Tên miền tùy chỉnh
Built with