Opsi Impor

Selama impor manual maupun impor terjadwal, Anda dapat menyesuaikan cara data diproses menggunakan Opsi Impor.

Pengaturan Umum

Target & Tujuan

Opsi	Deskripsi
Basic Auth	Digunakan untuk impor URL yang memerlukan autentikasi nama pengguna/kata sandi.
Target Branch	Pilih branch tertentu untuk mengimpor data (default ke `main`).
Import Into	Pilih untuk mengimpor ke folder/modul yang sudah ada atau membuat yang baru.
Auto Generate Case	Jika diaktifkan, Apidog secara otomatis membuat kasus pengujian "Success" jika spesifikasi tidak memiliki contoh.

Impor Lingkungan

Jika file OpenAPI/Swagger Anda mendefinisikan beberapa server, aktifkan Import Servers as Environments untuk secara otomatis membuat lingkungan yang sesuai di Apidog.

Keamanan & Penamaan

Skema Keamanan

Kontrol bagaimana securitySchemes dari OpenAPI ditangani.

Global Auth: Petakan keamanan global spesifikasi ke autentikasi folder Root di Apidog.

Undefined Auth: Tentukan perilaku untuk endpoint tanpa keamanan tertentu (misalnya, "Warisi dari induk" atau "Tanpa autentikasi").

Penamaan Endpoint

Jika endpoint tidak memiliki bidang Summary yang deskriptif, Anda dapat memilih sumber fallback untuk nama:

operationId (Default)

URL Path

Ekstraksi Description

Resolusi Konflik

Ketika data yang diimpor cocok dengan data yang sudah ada (berdasarkan Method & Path), gunakan aturan berikut untuk menentukan hasilnya.

Konflik Endpoint

Strategi	Perilaku
Overwrite	Sepenuhnya mengganti endpoint lama dengan data baru.
Keep Both	Membuat duplikat; yang lama dan yang baru ada berdampingan.
Ignore	Melewati endpoint baru; mempertahankan yang lama tanpa perubahan.
Merge	Pembaruan cerdas: mempertahankan perubahan manual seperti Nama, aturan Mock, dan Deskripsi sambil memperbarui definisi.
Overwrite Selected	Hanya memperbarui bidang tertentu yang Anda pilih, sambil mempertahankan bidang lainnya.

Sumber Daya Lain (Skema / Dokumen)

Untuk dokumen Markdown, Skema, dan Komponen, opsi Overwrite vs Merge yang serupa berlaku.

Logika Sinkronisasi Lanjutan

Sinkronisasi Folder

Ketika endpoint yang diimpor cocok dengan endpoint yang sudah ada dalam proyek, tetapi lokasi foldernya berbeda:

Keep existing folder: Mengabaikan jalur folder dalam file yang diimpor. Endpoint tetap berada di foldernya saat ini di Apidog.

Update endpoint folder: Memindahkan endpoint ke struktur folder yang didefinisikan dalam file yang diimpor.

Pembersihan Sumber Daya

Tentukan apa yang terjadi pada sumber daya yang sudah ada dalam proyek tetapi tidak ada dari file impor baru.

Do not delete (Aman): Mempertahankan sumber daya yatim dalam proyek Anda.

Delete (Sinkronisasi): Menghapus sumber daya apa pun yang tidak ada dalam file baru. Gunakan dengan hati-hati untuk mempertahankan cerminan spesifikasi yang persis.

Pengaturan Umum#

Target & Tujuan#

Impor Lingkungan#

Keamanan & Penamaan#

Skema Keamanan#

Penamaan Endpoint#

Resolusi Konflik#

Konflik Endpoint#

Sumber Daya Lain (Skema / Dokumen)#

Logika Sinkronisasi Lanjutan#

Sinkronisasi Folder#

Pembersihan Sumber Daya#