Tùy chọn nhập

Trong cả Nhập thủ công và Nhập theo lịch, bạn có thể tùy chỉnh cách dữ liệu được xử lý bằng Tùy chọn nhập.

Cài đặt chung

Mục tiêu & Đích đến

Tùy chọn	Mô tả
Basic Auth	Được sử dụng cho các lần nhập qua URL yêu cầu xác thực bằng tên người dùng/mật khẩu.
Target Branch	Chọn nhánh cụ thể để nhập dữ liệu vào (mặc định là `main`).
Import Into	Chọn nhập vào một thư mục/module hiện có hoặc tạo mới.
Auto Generate Case	Nếu được bật, Apidog sẽ tự động tạo một trường hợp kiểm thử "Success" nếu đặc tả không có ví dụ.

Nhập môi trường

Nếu tệp OpenAPI/Swagger của bạn định nghĩa nhiều máy chủ, hãy bật Import Servers as Environments để tự động tạo các môi trường tương ứng trong Apidog.

Bảo mật & Đặt tên

Lược đồ bảo mật

Kiểm soát cách xử lý securitySchemes từ OpenAPI.

Global Auth: Ánh xạ bảo mật toàn cục của đặc tả tới xác thực của thư mục Root trong Apidog.

Undefined Auth: Quyết định hành vi đối với các endpoint không có bảo mật cụ thể (ví dụ: "Kế thừa từ thư mục cha" hoặc "Không xác thực").

Đặt tên endpoint

Nếu một endpoint thiếu trường Summary mang tính mô tả, bạn có thể chọn nguồn dự phòng cho tên:

operationId (Mặc định)

URL Path

Trích xuất từ Description

Giải quyết xung đột

Khi dữ liệu được nhập khớp với dữ liệu hiện có (dựa trên Method & Path), hãy sử dụng các quy tắc này để quyết định kết quả.

Xung đột endpoint

Chiến lược	Hành vi
Overwrite	Thay thế hoàn toàn endpoint cũ bằng dữ liệu mới.
Keep Both	Tạo một bản trùng lặp; cả bản cũ và bản mới cùng tồn tại song song.
Ignore	Bỏ qua endpoint mới; giữ nguyên endpoint cũ không thay đổi.
Merge	Cập nhật thông minh: giữ lại các thay đổi thủ công như Tên, quy tắc Mock và Mô tả trong khi cập nhật định nghĩa.
Overwrite Selected	Chỉ cập nhật các trường cụ thể mà bạn chọn, bảo toàn các trường khác.

Tài nguyên khác (Schemas / Tài liệu)

Đối với tài liệu Markdown, Schemas và Components, các tùy chọn tương tự Overwrite và Merge được áp dụng.

Logic đồng bộ nâng cao

Đồng bộ hóa thư mục

Khi một endpoint được nhập khớp với một endpoint hiện có trong dự án, nhưng vị trí thư mục của chúng khác nhau:

Keep existing folder: Bỏ qua đường dẫn thư mục trong tệp được nhập. Endpoint vẫn nằm trong thư mục hiện tại của nó trong Apidog.

Update endpoint folder: Di chuyển endpoint đến cấu trúc thư mục được định nghĩa trong tệp được nhập.

Dọn dẹp tài nguyên

Quyết định điều gì sẽ xảy ra với các tài nguyên đã tồn tại trong dự án nhưng không có trong tệp nhập mới.

Do not delete (An toàn): Giữ lại các tài nguyên mồ côi trong dự án của bạn.

Delete (Đồng bộ): Xóa mọi tài nguyên không có trong tệp mới. Hãy thận trọng khi sử dụng để duy trì một bản phản chiếu chính xác của đặc tả.

Cài đặt chung#

Mục tiêu & Đích đến#

Nhập môi trường#

Bảo mật & Đặt tên#

Lược đồ bảo mật#

Đặt tên endpoint#

Giải quyết xung đột#

Xung đột endpoint#

Tài nguyên khác (Schemas / Tài liệu)#

Logic đồng bộ nâng cao#

Đồng bộ hóa thư mục#

Dọn dẹp tài nguyên#