⭐ Rilis bulan Mei adalah rilis praktis yang berfokus pada pengurangan pekerjaan penyiapan setelah migrasi, penguatan keamanan otentikasi perusahaan, dan membuat keluaran debugging API sehari-hari lebih lengkap.
Ketika tim memindahkan pekerjaan API antar alat, bagian yang sulit jarang hanya sekadar mengimpor file. Gesekan yang sebenarnya muncul setelah impor: URL dasar perlu diperbaiki, lingkungan perlu dihubungkan, kode yang dihasilkan memerlukan otentikasi, dan runner CI perlu sesuai dengan aturan infrastruktur yang lebih ketat.
Bulan ini, Apidog meningkatkan bagian-bagian alur kerja tersebut. Impor Postman kini menyertakan pemetaan URL Dasar yang lebih cerdas, Kebijakan Perusahaan dimulai dengan kontrol Keamanan Otentikasi, Mode Spec-First dapat dicoba tanpa mengikat Git terlebih dahulu, Runner dapat berjalan tanpa hak akses root, kode permintaan yang dihasilkan dapat menyertakan informasi otentikasi, dan beberapa masalah berbagi permintaan, sinkronisasi pengujian, dan pembuatan data Mock telah dibersihkan.
Berikut adalah perubahan bulan ini:
⭐ Pembaruan Baru
📦 Impor Data Postman dengan Pemetaan URL Dasar yang Lebih Cerdas
Ketika Apidog dapat secara andal mendeteksi URL Dasar bersama selama impor Postman, ini dapat membantu menempatkan nilai tersebut di bidang URL Dasar untuk modul yang sesuai di seluruh lingkungan Anda.
Untuk tim yang bermigrasi dari Postman, ini mengurangi langkah pembersihan yang umum. Setelah impor, permintaan lebih mungkin siap untuk dikirim tanpa perlu memeriksa URL yang diimpor secara manual dan mengisi URL Dasar modul satu per satu di setiap lingkungan.
| Sebelum | Sekarang |
|---|---|
|
|
Peningkatan ini mendukung impor file Postman lokal dan impor melalui Postman API. Ketika URL permintaan berisi alamat bersama yang jelas atau variabel yang dapat dikenali, Apidog akan mencoba mengekstrak URL Dasar yang dapat digunakan dan menempatkannya di tempat URL Dasar modul dikonfigurasi di lingkungan yang relevan.
🛡️ Kebijakan Perusahaan Dimulai dengan Kontrol Keamanan Otentikasi
Apidog memperkenalkan Kebijakan Perusahaan sebagai kerangka kerja tata kelola untuk kontrol keamanan tingkat organisasi, dimulai dengan Keamanan Otentikasi.
Keamanan Otentikasi berfokus pada pengurangan paparan kredensial dalam konfigurasi otentikasi. Administrator organisasi dapat menentukan aturan untuk bidang Otentikasi yang sensitif, seperti mendorong atau mengharuskan kredensial disimpan sebagai variabel atau Rahasia Vault alih-alih nilai mentah.
Untuk Rahasia Vault, tim juga dapat mencegah pengungkapan teks biasa di UI. Anggota masih dapat mereferensikan rahasia untuk eksekusi permintaan, tetapi nilainya tidak secara tidak sengaja terungkap melalui ikon mata atau berbagi layar.
🔒 Ini memberikan tim perusahaan cara yang lebih jelas untuk mengatur kredensial otentikasi tanpa mengubah debugging API menjadi proses keamanan yang terpisah.
📝 Mode Spec-First Tidak Lagi Membutuhkan Penyiapan Git Terlebih Dahulu
Mode Spec-First kini lebih mudah dicoba. Anda dapat membuat proyek Spec-First tanpa mengikat repositori Git terlebih dahulu, lalu menambahkan atau mengimpor file OpenAPI saat Anda siap.
Ini menurunkan hambatan bagi tim yang ingin menjelajahi alur kerja yang ramah file dan berpusat pada OpenAPI di Apidog sebelum berkomitmen pada penyiapan berbasis Git sepenuhnya.
ℹ️ Ini sangat berguna bagi tim yang mengevaluasi alur kerja Spec-First atau mengumpulkan umpan balik awal sebelum menstandardisasi struktur repositori.
🔒 Runner Kini Dapat Berjalan sebagai Pengguna Non-Root
Runner kini mendukung berjalan sebagai pengguna non-root.
Ini sangat berguna di lingkungan server, kontainer, dan CI/CD yang lebih ketat di mana menjalankan proses sebagai root tidak dianjurkan atau diblokir oleh kebijakan. Tim dapat menyebarkan Runner dengan jejak izin yang lebih kecil sambil tetap sesuai dengan alur kerja otomatisasi yang ada.
✅ Pembaruan ini membantu tim menyelaraskan penerapan Runner dengan persyaratan keamanan internal tanpa mengubah alur kerja pengujian secara keseluruhan.
🔐 Kode Permintaan yang Dihasilkan Dapat Menyertakan Informasi Otentikasi
Saat membuat kode permintaan dari permintaan API, Apidog kini dapat menyertakan informasi otentikasi yang telah dikonfigurasi.
Itu berarti cuplikan yang dihasilkan lebih dekat dengan sesuatu yang dapat Anda jalankan secara langsung. Alih-alih secara manual menambahkan token, header, atau parameter otentikasi lainnya setelah ekspor, pengembang bisa mendapatkan contoh yang lebih lengkap sejak awal.
Ini berguna ketika Anda perlu memverifikasi panggilan API dengan cepat, berbagi contoh yang dapat dijalankan dengan rekan tim, atau menempelkan permintaan ke konteks debugging lain.
✅ Optimasi
🧩 Eksekusi Skrip CLI Kini Lebih Terbatas
Untuk mengurangi risiko eksekusi skrip, CLI kini hanya mengizinkan skrip dari direktori “Program Eksternal” untuk dipanggil.
Jika tim Anda menggunakan skrip CLI dalam alur otomatisasi, ada baiknya memeriksa apakah jalur skrip yang ada cocok dengan aturan eksekusi baru. Batas yang lebih ketat ini membantu mengurangi eksekusi skrip yang tidak disengaja atau terlalu luas sambil tetap menjaga alur kerja program eksternal yang dimaksudkan tetap tersedia.
📋 Perintah cURL yang Disalin Menyertakan Lebih Banyak Konfigurasi Permintaan
Saat menyalin cURL dari Apidog, perintah yang dihasilkan kini menyertakan parameter Header dan Body yang dikonfigurasi dengan lebih andal.
Ini membuat perintah cURL yang disalin lebih dekat dengan permintaan aktual yang Anda konfigurasikan di aplikasi. Baik Anda melakukan debugging di terminal, berbagi permintaan yang dapat direproduksi, atau menambahkan perintah ke catatan pemecahan masalah, lebih sedikit pembersihan manual yang diperlukan.
🧪 Langkah Pengujian Otomatis Tetap Sinkron Setelah Perubahan Metode
Ketika metode permintaan endpoint berubah dari GET ke POST, PUT, atau metode lain, langkah pengujian otomatis terkait kini menyinkronkan konfigurasi yang diperbarui dengan lebih akurat.
Ini mengurangi ketidakcocokan pengujian yang disebabkan oleh informasi metode permintaan yang usang dan membuat hasil pengujian otomatis lebih mudah dipercaya setelah pembaruan endpoint.
🎲 Pembuatan Data Mock yang Lebih Andal
Rilis ini memperbaiki beberapa masalah pembuatan data Mock, termasuk aturan pengganda, ekspresi arrayElements, dan masalah pembuatan batch ketika pembuatan JavaScript dan pembuatan Mock digunakan bersamaan.
Untuk integrasi frontend-backend, pembuatan data pengujian massal, dan pengujian otomatis, keluaran Mock sekarang akan lebih stabil dan lebih dekat dengan aturan yang Anda konfigurasikan.
🐞 Perbaikan Bug dan Peningkatan Kecil
Kami juga merilis serangkaian perbaikan dan peningkatan kualitas hidup bulan ini, termasuk:
- Memperbaiki masalah di mana parameter permintaan dokumentasi bersama tidak menampilkan contoh default.
- Memperbaiki masalah di mana mengekspor proyek hanya dengan dokumen Markdown dan tanpa endpoint dapat gagal.
- Memperbaiki beberapa masalah pembuatan data Mock, termasuk pembuatan batch ketika pembuatan JavaScript dan pembuatan Mock keduanya digunakan, aturan pengganda angka, dan ekspresi min dan max
arrayElements. - Memperbaiki masalah di mana tautan tetap gambaran umum proyek dapat mengembalikan kesalahan 500 setelah membuka tautan dari proyek yang berbeda secara berurutan.
- Memperbaiki masalah di mana antarmuka dapat menampilkan
Error: Cannot read properties of null (reading 'nullable')dalam beberapa kasus. - Memperbaiki masalah kontras di mana nama contoh yang dipilih dalam dokumentasi bersama mungkin sulit dibaca dalam tema terang.
- Memperbaiki masalah di mana pengguna Windows tidak dapat menggunakan AI Agent Debugger secara normal.
- Memperbaiki masalah di mana bidang body form-data dengan beberapa file yang diunggah hanya akan menampilkan satu file setelah membuka edit batch dan menyimpan.
🌟 Apa Artinya Ini
Bulan Mei adalah tentang menghilangkan sumber gesekan kecil namun mahal dari alur kerja API.
| Area | Apa yang ditingkatkan | Mengapa itu penting |
|---|---|---|
| Migrasi Postman | URL Dasar bersama dipetakan ketika Apidog dapat mendeteksinya secara andal. | Lebih sedikit pembersihan manual setelah mengimpor koleksi dan mengkonfigurasi lingkungan. |
| Penerapan Runner | Runner dapat berjalan sebagai pengguna non-root. | Lebih cocok untuk kebijakan server, kontainer, dan CI/CD yang lebih ketat. |
| Keamanan perusahaan | Kebijakan Perusahaan dimulai dengan kontrol Keamanan Otentikasi. | Admin dapat mengurangi paparan kredensial mentah dalam alur kerja otentikasi. |
| Alur kerja Spec-First | Proyek Spec-First tidak lagi memerlukan pengikatan Git sebelum digunakan. | Tim dapat mencoba pekerjaan yang berpusat pada OpenAPI sebelum menyiapkan alur kerja repositori. |
| Berbagi permintaan | Kode yang dihasilkan dan keluaran cURL menyertakan lebih banyak konfigurasi permintaan. | Contoh lebih mudah dijalankan, direproduksi, dan dibagikan. |
| Pengujian dan Mocking | Langkah pengujian disinkronkan lebih akurat dan pembuatan Mock lebih stabil. | Tim menghabiskan lebih sedikit waktu untuk mengejar perubahan konfigurasi dan data pengujian yang tidak terduga. |
Tidak ada pembaruan ini yang tentang menambahkan kompleksitas. Ini tentang membuat pekerjaan setelah penyiapan terasa kurang rapuh: lebih sedikit perbaikan manual, default yang lebih aman, dan keluaran yang lebih sesuai dengan apa yang telah Anda konfigurasikan.
💬 Bergabunglah dalam Percakapan
Terhubung dengan sesama insinyur API dan tim Apidog:
- Bergabunglah dengan komunitas Discord kami untuk diskusi dan dukungan secara real-time.
- Berpartisipasi dalam komunitas Slack kami untuk percakapan teknis.
- Ikuti kami di X (Twitter) untuk pembaruan terbaru.
P.S. Untuk detail lengkap semua pembaruan, lihat Changelog Apidog!
Hormat kami,
Tim Apidog