Di seluruh Apidog 2.8.47–2.8.50, pembaruan bulan ini membuat otomatisasi API, integrasi repositori, dan dokumentasi API lebih mudah dikelola—mulai dari impor CLI modular dan pembuatan kasus debug hingga koneksi Bitbucket Cloud, GitLab yang di-hosting sendiri, dan skema yang dipublikasikan dari sub-situs Docs.
Rilis ini bertujuan untuk membuat otomatisasi dan kolaborasi Git tidak lagi menjadi jalan memutar yang memakan waktu.
Pembaruan Apidog bulan September berfokus pada titik-titik di mana tim sering kehilangan waktu: mengelola struktur proyek besar dari skrip atau alur kerja AI, mengimpor aset API ke modul yang tepat, membuat aset pengujian tanpa meninggalkan terminal, dan menghubungkan penyedia Git yang ada tanpa mengubah cara tim sudah bekerja.
Sekilas:
- Otomatisasi Apidog CLI: mengelola modul proyek, mengimpor data API multi-format berdasarkan modul, dan membuat kasus pengujian debug dari file konfigurasi.
- Integrasi repositori Git: menambahkan koneksi Bitbucket Cloud dan GitLab On-Prem ke alur kerja impor/ekspor proyek.
- Kegunaan sehari-hari: penanganan URL yang lebih jelas, pemfilteran laporan pengujian yang lebih baik, penyelesaian variabel data pengujian, dan daftar proyek yang lebih cepat.
- Visibilitas Dokumen dan kinerja: Sub-situs Dokumen mempublikasikan skema, dan pengujian kinerja melaporkan waktu respons P95 dan P99.
🤖 Apidog CLI untuk Otomatisasi API dan Alur Kerja AI
Apidog CLI telah menjadi titik masuk yang berguna untuk menjalankan pengujian CI dan otomatisasi. Rilis ini memperluasnya lebih awal dalam alur kerja: tim dapat mengelola struktur proyek, membawa data ke modul yang tepat, dan membuat kasus debug sebelum menjalankan pengujian.
Mengelola modul proyek dari CLI
Apidog CLI sekarang dapat mengkueri, membuat, memperbarui, dan menghapus modul proyek.
Ini berguna ketika struktur modul perlu diubah sebagai bagian dari alur kerja otomatis. Setelah operasi penulisan, CLI mengembalikan JSON terstruktur yang menyertakan moduleId, sehingga skrip dan agen dapat meneruskan pengidentifikasi ke langkah-langkah impor, pengujian, atau pemeliharaan selanjutnya daripada meminta seseorang untuk menyalinnya dari UI.
Hal ini menjadikan manajemen modul sebagai bagian dari loop yang sama dan dapat diulang seperti pengujian API dan otomatisasi CI.
Mengimpor data API ke modul yang dipilih
Perintah impor CLI telah direfaktor untuk menggunakan kembali kemampuan penguraian klien Apidog. Anda dapat mengimpor data API dari sumber yang didukung ke modul proyek tertentu alih-alih membuat data terlebih dahulu di UI dan memindahkannya nanti.
Untuk migrasi yang lebih besar, hasil impor mencakup jumlah item yang ditambahkan, diperbarui, diabaikan, dan dihapus. Hal ini memudahkan skrip, pekerjaan CI, dan agen AI untuk memverifikasi apa yang terjadi sebelum melanjutkan ke langkah berikutnya.
Ini sangat berguna ketika beberapa format perlu ditempatkan dalam struktur proyek yang sama dengan lebih sedikit langkah pembersihan manual.
Membuat kasus pengujian debug dari konfigurasi
Pengguna CLI sekarang dapat membuat kasus pengujian debug antarmuka dari file konfigurasi. Sebuah konfigurasi dapat mendefinisikan nama kasus, API target, parameter permintaan, isi permintaan, otentikasi, pra-prosesor, pasca-prosesor, dan validasi respons.
Setelah dibuat, kasus debug dapat dibuka, diedit, dan dieksekusi di Apidog seperti kasus debug lainnya. Ini berguna ketika otomatisasi atau agen menyiapkan aset pengujian awal, tetapi pengembang masih ingin memeriksa dan memperbaikinya secara visual.
Bersama-sama, manajemen modul, impor terstruktur, dan pembuatan kasus debug mengurangi pekerjaan manual di seluruh skrip lokal, pipeline CI/CD, dan alur kerja yang dibantu AI.
Jika Anda sudah menginstal Apidog CLI, perbarui sebelum menggunakan kemampuan baru:
npm install -g apidog-cli@latestLihat dokumentasi Apidog CLI untuk referensi perintah terbaru.
🔗 Integrasi Repositori Git
September juga memperluas impor/ekspor berbasis Git ke dua lingkungan repositori umum.
Bitbucket Cloud
Impor dan ekspor proyek sekarang mendukung repositori Bitbucket Cloud. Tim yang sudah menggunakan Bitbucket Cloud dapat menjaga repositori yang ada dalam alur kerja alih-alih memindahkan aset API ke platform Git lain.
GitLab On-Prem
Organisasi dapat mengonfigurasi instance GitLab On-Prem di Apidog SaaS dan menggunakannya dalam alur kerja repositori Git yang didukung. Setiap organisasi mengelola koneksinya secara independen, sehingga tim dapat terus menggunakan pengaturan GitLab yang di-hosting sendiri.
Sebelum menghubungkan, pastikan alamat instance GitLab dan lingkungan jaringan memenuhi persyaratan koneksi.
⚙️ Perbaikan Sehari-hari
Rilis ini juga mengatasi umpan balik yang sering diterima dari pekerjaan API sehari-hari.
URL lengkap tidak lagi bertentangan dengan jalur lingkungan
Saat membuat atau mengedit API HTTP, memasukkan URL lengkap yang dimulai dengan http:// atau https:// sekarang akan segera menyembunyikan jalur lingkungan. Mengubah nilai kembali ke jalur relatif akan mengembalikan jalur lingkungan.
Ini menghilangkan kebingungan melihat URL lengkap dan jalur lingkungan secara bersamaan, dan menghilangkan kebutuhan untuk menyimpan terlebih dahulu untuk melihat perilakunya.
Pemfilteran laporan pengujian yang lebih berguna
Daftar laporan pengujian sekarang mendukung pemfilteran berdasarkan runner dan sumber eksekusi. Bidang tampilan terkait juga telah ditambahkan, sehingga lebih mudah untuk mempersempit daftar laporan yang panjang dan membandingkan catatan terbaru dari berbagai asal.
Variabel data pengujian muncul dalam penyelesaian
Variabel data pengujian yang ada sekarang muncul di penyelesaian kode dan penyelesaian nilai dinamis. Saat menulis permintaan atau pengujian, Anda dapat mencari dan memilih variabel secara langsung alih-alih beralih kembali ke daftar variabel untuk menyalin namanya.
Daftar proyek yang lebih cepat
Apidog mengoptimalkan waktu respons API daftar proyek. Daftar proyek memuat lebih cepat saat memasuki ruang kerja atau menemukan proyek, mengurangi waktu tunggu selama navigasi dan perpindahan yang sering.
✨ Juga dalam Rilis Ini
Tiga perubahan melengkapi bulan ini, mencakup dokumentasi, pengujian kinerja, dan pengaturan proyek spec-first.
Mempublikasikan skema dari sub-situs Docs
Sub-situs di Apidog Docs sekarang dapat mempublikasikan skema bersama dengan endpoint, sehingga pembaca situs yang dipublikasikan dapat melihatnya di tempat alih-alih beralih kembali ke situs utama. Sub-situs perusahaan dapat mengaktifkan kemampuan ini sendiri.
Waktu respons P95 dan P99 dalam pengujian kinerja
Hasil pengujian kinerja sekarang melaporkan waktu respons P95 dan P99 bersama dengan metrik yang ada. Persentil menggambarkan ekor lambat yang disembunyikan oleh rata-rata, yang biasanya merupakan bagian dari API yang benar-benar diperhatikan pengguna.
Pengaturan proyek Mode Spec dan impor OpenAPI
Proyek Mode Spec sekarang dibuka ke keadaan kosong yang lebih jelas, dengan impor OpenAPI dan titik masuk pembuatan yang muncul langsung, sehingga proyek spec-first dapat dimulai tanpa mencari jalannya.
🛠️ Perbaikan dan Peningkatan Tambahan
Siklus ini juga mencakup perbaikan dan perubahan kecil berikut:
- Meningkatkan cara status uji coba dan tindakan ditampilkan di jendela utama dan bilah tab.
- Meningkatkan cara undangan tertunda muncul di daftar anggota organisasi dan tim.
- Memperbaiki masalah di mana variabel Basic Auth dalam kode permintaan yang dihasilkan tidak diperluas dan dikodekan langsung sebagai Base64.
- Memperbaiki masalah di mana pengeditan tab tidak memperluas bidang model data gabungan yang direferensikan menggunakan
allOf. - Memperbaiki masalah di mana referensi API antar proyek ke model data salah setelah mengkloning atau menyalin proyek.
- Memperbaiki masalah di mana kasus debug yang dibuat oleh CLI menampilkan jenis otentikasi sebagai "No Auth" di klien Web dan tidak menerapkan otentikasi.
- Memperbaiki masalah di mana definisi
$refrespons OpenAPI diam-diam dibuang selama impor CLI. - Memperbaiki masalah di mana metadata paginasi daftar laporan mengembalikan nilai
pageSizedanpageIndexyang salah. - Memperbaiki masalah di mana pembuatan laporan pengujian JUnit dan HTML membuat laporan JUnit hanya berisi hasil kasus pengujian terakhir.
- Memperbaiki masalah di mana dropdown lingkungan tidak dapat dibuka saat beralih lingkungan URL dalam pengujian API tunggal.
- Menambahkan dukungan untuk menonaktifkan entri hadiah undangan beranda melalui Kebijakan Perusahaan.
Untuk daftar lengkap item per item, jelajahi Apidog Changelog.
🌟 Apa Artinya Ini
September adalah rilis praktis untuk tim yang pekerjaannya semakin melibatkan orang, skrip, agen, dan repositori Git.
| Fokus | Apa yang ditingkatkan | Mengapa penting |
|---|---|---|
| CLI dan otomatisasi | Modul, impor, dan kasus debug dapat dibuat dan dikelola melalui CLI. | Otomatisasi dan agen dapat berpartisipasi lebih awal tanpa pengaturan UI manual. |
| Kolaborasi Git | Bitbucket Cloud dan GitLab On-Prem terhubung ke alur kerja proyek. | Tim dapat mempertahankan repositori yang sudah mereka operasikan. |
| Kualitas sehari-hari | Penanganan URL, pemfilteran laporan, penyelesaian variabel, dan pemuatan proyek meningkat. | Langkah-langkah pengaturan dan peninjauan umum membutuhkan lebih sedikit perhatian. |
| Dokumen, pengujian, dan spesifikasi | Skema dipublikasikan dengan sub-situs Dokumen, hasil kinerja melaporkan P95 dan P99, dan Mode Spec mendapatkan awal yang lebih jelas. | Skema, latensi, dan konteks spec-first terlihat tanpa meninggalkan alur kerja. |
💬 Tetap Berhubungan
Ada umpan balik atau pertanyaan? Terhubung dengan sesama insinyur API dan tim Apidog:
- Bergabunglah dengan komunitas Discord kami untuk diskusi dan dukungan waktu nyata.
- Berpartisipasi dalam komunitas Slack kami untuk percakapan teknis.
- Ikuti kami di X (Twitter) dan LinkedIn untuk pembaruan terbaru.
P.S. Untuk setiap detail dalam rilis ini, periksa Apidog Changelog.
Hormat kami,
Tim Apidog