Impor Terjadwal secara otomatis menyinkronkan spesifikasi API Anda dari sumber eksternal ke Apidog pada interval reguler. Fitur ini ideal untuk tim yang mengelola spesifikasi API mereka di sistem eksternal (seperti repositori Git atau endpoint Swagger) tetapi ingin memanfaatkan kemampuan debugging dan pengujian Apidog yang kuat tanpa impor ulang secara manual.Dengan Impor Terjadwal, Anda dapat:Mempertahankan satu sumber kebenaran untuk spesifikasi API Anda di sistem kontrol versi pilihan Anda
Menyinkronkan perubahan secara otomatis pada interval yang dapat disesuaikan (setiap 30 menit, setiap jam, harian, dll.)
Mengimpor dari beberapa sumber termasuk GitHub, GitLab, Azure DevOps, dan URL langsung
Menjaga tim Anda tetap selaras dengan perubahan API terbaru tanpa intervensi manual
Cara Mengonfigurasi#
1
Navigasikan ke PengaturanBuka Settings -> Import Data -> Scheduled Import (Bind Data Sources).
2
Buat Sumber DataKlik "New" untuk menambahkan konfigurasi.
3
Konfigurasikan PengaturanIsi detail sumber data (URL, Frekuensi, dll.). Buka bagian berikutnya untuk detail tentang mengikat repositori git.
4
Simpan dan AktifkanKlik Save. Impor kini akan berjalan secara otomatis berdasarkan pengaturan frekuensi Anda.
Apidog mendukung pembuatan beberapa sumber data dalam satu proyek, masing-masing menyinkronkan dan mengimpor ke folder yang berbeda.
Mengikat Repositori Git#
Apidog mendukung pengikatan repositori git dari:Untuk mengikat repositori git, ikuti langkah-langkah berikut.1
Pilih opsi
Git Repository pada kotak dialog
Bind Data Sources dan buat koneksi repositori.
2
Setelah memilih platform kontrol versi pilihan Anda, ikuti instruksi untuk memberikan Apidog akses ke repositori Anda.
3
Saat Anda dialihkan kembali ke Apidog, pilih
Organization dan
Repository Anda, lalu klik
Save.
4
Terakhir, pilih Branch dan file OpenAPI Spec, lalu selesaikan proses pengikatan.
Referensi Konfigurasi#
| Pengaturan | Deskripsi |
|---|
| Frekuensi impor | Seberapa sering Apidog memeriksa dan mengimpor pembaruan dari sumber data Anda. Opsi mencakup setiap 30 menit, setiap jam, harian, atau interval khusus. |
| Format sumber | Format spesifikasi file API Anda. Format yang didukung: OpenAPI (Swagger), ApiDoc, atau format native Apidog. |
| URL sumber | Tautan HTTP(S) langsung ke file spesifikasi API Anda. Contoh: https://petstore.swagger.io/v2/swagger.json. Harus dapat diakses secara publik atau dilindungi dengan Basic Auth. |
| Berjalan pada | Lingkungan eksekusi untuk tugas impor. Pilih Local Client (berjalan saat aplikasi Anda terbuka) atau Runner (berjalan pada server self-hosted 24/7). |
| Basic auth | Kredensial nama pengguna dan kata sandi jika URL Sumber Anda dilindungi oleh HTTP Basic Authentication. Biarkan kosong untuk URL publik. |
Mode Eksekusi#
Impor terjadwal memerlukan lingkungan eksekusi untuk menjalankan perintah fetch. Pilih mode yang paling sesuai dengan alur kerja Anda:1. Local Client (Default)#
Impor berjalan hanya ketika aplikasi desktop Apidog Anda terbuka.Persyaratan: Anda harus membuka proyek dengan izin tulis.
Batasan: Jika Anda menutup aplikasi atau proyek, pembaruan akan dijeda hingga Anda membukanya kembali.
Jaringan: Dapat mengakses URL jaringan internal jika komputer Anda dapat mengaksesnya.
Membuka proyek di Apidog Web App juga memicu impor terjadwal. Namun, karena pembatasan keamanan browser, Web App mungkin tidak dapat mengakses URL jaringan internal.
2. Self-hosted Runner#
Impor berjalan pada server tempat Anda telah menerapkan Apidog Runner.Manfaat: Berjalan 24/7 terlepas dari apakah Anda sedang online.
Kasus Penggunaan: Paling sesuai untuk tim yang membutuhkan pembaruan konsisten tanpa intervensi manual.
Lanjutan: Impor ke Cabang Sprint#
Anda dapat menargetkan cabang sprint tertentu untuk impor Anda. Secara default, data diimpor ke Main Branch. 
