Apidog Docs
🇮🇩 Bahasa Indonesia
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇮🇩 Bahasa Indonesia
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇮🇩 Bahasa Indonesia
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. Menggunakan skrip
  • Pusat Pembelajaran Apidog
  • Memulai
    • Pengantar Apidog
    • Konsep Dasar di Apidog
    • Menavigasi Apidog
    • Mulai cepat
      • Ikhtisar
      • Membuat Endpoint
      • Membuat Permintaan
      • Menambahkan Aservi
      • Membuat Skenario Pengujian
      • Membagikan Dokumentasi API
      • Jelajahi Lebih Lanjut
    • Migrasi ke Apidog
      • Ikhtisar
      • Impor Manual
      • Impor Terjadwal (Ikat Sumber Data)
      • Opsi Impor
      • Ekspor Data
      • Impor dari
        • Impor dari Postman
        • Impor Spesifikasi OpenAPI
        • Impor cURL
        • Impor Markdown
        • Impor dari Insomnia
        • Impor dari apiDoc
        • Impor File .har
        • Impor WSDL
  • Data API mock
    • Ikhtisar
    • Smart Mock
    • Mock Kustom
    • Urutan Prioritas Mock
    • Mock Scripts
    • Cloud Mock
    • Mock Runner Self-Hosted
    • Bahasa Mock (Lokal)
  • Akun dan preferensi
    • Pengaturan Akun
    • Membuat Token Akses OpenAPI
    • Notifikasi
    • Pengaturan Bahasa
    • Tombol Pintas
    • Konfigurasi Proxy Jaringan
    • Mencadangkan Data
    • Memperbarui Apidog
    • Menghapus Akun
    • Fitur Eksperimental
  • Kirim request
    • Ikhtisar
    • Debugging SSE
    • MCP Client
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP atau WebService
    • GraphQL
    • gRPC
    • Gunakan Agen Proksi Permintaan untuk Debugging
    • Buat request
      • Riwayat Permintaan
      • Dasar-Dasar Permintaan
      • Parameter dan Body
      • Header Permintaan
      • Pengaturan Permintaan
      • Debug Permintaan
      • Menyimpan Permintaan sebagai Endpoint
      • HTTP/2
    • Autentikasi dan otorisasi
      • Ikhtisar
      • Sertifikat CA dan Klien
      • Jenis Otorisasi
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Autentikasi Hawk
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • Respons dan cookie
      • Melihat Respons API
      • Mengelola Cookie
      • Ikhtisar
  • Mengembangkan dan men-debug API
    • Ikhtisar
    • Membuat Permintaan
    • Mengirim Permintaan
    • Kasus Debugging
    • Kasus Pengujian
    • Nilai Dinamis
    • Memvalidasi Respons
    • Design-First vs Request-First
    • Menghasilkan Kode
    • Environment dan variabel
      • Ikhtisar
      • Menggunakan Variabel
      • Manajemen Lingkungan
    • Rahasia vault
      • Gambaran Umum
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • Modul nilai dinamis
      • Airline
      • Animal
      • Warna
      • Commerce
      • Perusahaan
      • Database
      • Tipe Data
      • Tanggal
      • Keuangan
      • Food
      • Git
      • Hacker
      • Helpers
      • Image
      • Internet
      • Lokasi
      • Lorem
      • Musik
      • Number
      • Orang
      • Telepon
      • Sains
      • String
      • System
      • Vehicle
      • Word
    • Pra dan pascaprosesor
      • Ikhtisar
      • Aservi
      • Ekstrak Variabel
      • Tunggu
      • Keamanan
      • Operasi basis data
        • Ikhtisar
        • MySQL
        • MongoDB
        • Redis
        • Oracle Client
      • Menggunakan skrip
        • Ikhtisar
        • Skrip Pra-Pemroses
        • Skrip Post-processor
        • Skrip Publik
        • Referensi Skrip Postman
        • Memanggil Bahasa Pemrograman Lain
        • Menggunakan Pustaka JS
        • Memvisualisasikan Respons
        • Contoh skrip
          • Skrip Aservi
          • Menggunakan Variabel
          • Memodifikasi Permintaan
          • Contoh Lainnya
    • Debugging API
      • AI Agent Debugger
      • A2A Debugger
  • Mendesain API
    • Ikhtisar
    • Membuat Proyek API Baru
    • Dasar-Dasar Endpoint
    • Panduan Desain API
    • Modul
    • Mengonfigurasi Beberapa Contoh Body Permintaan
    • Komponen
    • Field Umum
    • Parameter Global
    • Riwayat Perubahan Endpoint
    • Komentar
    • Manajemen Endpoint Batch
    • Custom Protocol API
    • Mode Spec-first (Beta)
    • Skema keamanan
      • Gambaran Umum
      • Membuat Skema Keamanan
      • Menggunakan Skema Keamanan
      • Skema Keamanan dalam Dokumentasi Online
    • Fitur lanjutan
      • Bidang Endpoint Kustom
      • Skenario Pengujian Terkait
      • Status Endpoint
      • Tampilan Daftar Parameter
      • Identifikasi Unik Endpoint
    • Schemas
      • Gambaran Umum
      • Membuat Schema Baru
      • Membangun Schema
      • Hasilkan Skema dari JSON dan Sebagainya
      • oneOf, allOf, anyOf
      • Menggunakan Discriminator
  • Pengujian API
    • Gambaran Umum
    • Skenario pengujian
      • Membuat Skenario Pengujian
      • Meneruskan Data Antar Permintaan
      • Kondisi Kontrol Alur
      • Sinkronisasi Data dari Endpoint dan Kasus Endpoint
      • Mengimpor Endpoint dan Kasus Endpoint dari Proyek Lain
      • Mengekspor Skenario Pengujian
    • Laporan pengujian
      • Laporan Pengujian
    • Jalankan skenario pengujian
      • Menjalankan Skenario Pengujian
      • Menjalankan Skenario Pengujian secara Batch
      • Pengujian Berbasis Data
      • Data Pengujian Bersama
      • Tugas Terjadwal
      • Mengelola Lingkungan Runtime API dari Proyek Lain
    • Suite pengujian
      • Ikhtisar
      • Membuat Rangkaian Pengujian
      • Mengorkestrasi Test Suite
      • Menjalankan Rangkaian Pengujian Secara Lokal
      • Menjalankan Suite Pengujian Melalui CLI
      • Tugas terjadwal
    • Uji API
      • Pengujian Integrasi
      • Pengujian Performa
      • Pengujian End-to-End
      • Pengujian Regresi
      • Pengujian Kontrak
    • Apidog CLI
      • Ikhtisar
      • Menginstal dan Menjalankan Apidog CLI
      • Opsi Apidog CLI
    • CI/CD
      • Ikhtisar
      • Integrate with Github Actions
      • Integrasikan dengan Gitlab
      • Integrate with Jenkins
      • Memicu Pengujian melalui Git Commit
  • Publikasikan dokumentasi API
    • Gambaran Umum
    • Teknologi API yang Didukung
    • Berbagi Cepat
    • Melihat Dokumentasi API
    • Dokumentasi Markdown
    • Menerbitkan Situs Dokumentasi
    • Halaman Login Kustom
    • Tata Letak Kustom
    • CSS, JavaScript, HTML Kustom
    • Domain Kustom
    • Fitur AI
    • Pengaturan SEO
    • Pengaturan lanjutan
      • Pencarian Dokumentasi
      • Proxy CORS
      • Mengintegrasikan Google Analytics
      • Pengaturan Pohon Folder
      • Pengaturan Visibilitas
      • Menyematkan Nilai dalam URL Dokumentasi
    • Versi API
      • Gambaran Umum
      • Membuat Versi API
      • Menerbitkan Versi API
      • Membagikan Endpoint dengan Versi API
  • Branch
    • Ikhtisar
    • Membuat Cabang Sprint
    • Menguji API dalam Branch
    • Merancang API dalam Cabang
    • Menggabungkan Cabang Sprint
    • Mengelola Cabang Sprint
    • AI Branch (Beta)
  • Fitur AI
    • Ikhtisar
    • Mengaktifkan Fitur AI
    • Membuat Kasus Pengujian
    • Memodifikasi Skema dengan AI
    • Pemeriksaan Kepatuhan Endpoint
    • Pemeriksaan Kelengkapan Dokumentasi API
    • Penamaan Field Berbasis AI
    • Tanya Jawab Umum
  • Server MCP Apidog
    • Ikhtisar
    • Hubungkan Proyek Apidog ke AI
    • Menghubungkan Dokumentasi yang Dipublikasikan ke AI
    • Menghubungkan File OpenAPI ke AI
  • Praktik terbaik
    • Menangani Tanda Tangan API
    • Mengakses API yang Dilindungi OAuth 2.0
    • Alur Kerja Kolaborasi
    • Mengelola Status Autentikasi
  • Ruang offline
    • Gambaran Umum
  • Administrasi
    • Mengelola proyek
      • Mengelola Proyek
      • Pengaturan Notifikasi
      • Mengelola Anggota Proyek
      • Resource proyek
        • Koneksi Database
        • Koneksi Git
    • Mengelola tim
      • Mengelola Tim
      • Mengelola Anggota Tim
      • Aktivitas Tim
      • Peran & Izin Tim
      • Resource tim
        • General Runner
        • Variabel Tim
        • Request Proxy Agent
      • Kolaborasi real-time
        • Kolaborasi Tim
    • Checklist onboarding
      • Konsep Dasar
      • Panduan Onboarding
    • Mengelola organisasi
      • Mengelola Organisasi
      • Peran & Izin Organisasi
      • Manajemen paket
        • Manajer Penagihan di Organisasi
      • Single Sign-On (SSO)
        • Ikhtisar SSO
        • Mengonfigurasi Microsoft Entra ID
        • Mengonfigurasi Okta
        • Mengonfigurasi SSO untuk Organisasi
        • Mengelola Akun Pengguna
        • Memetakan Grup ke Tim
      • Provisioning SCIM
        • Pengantar Provisioning SCIM
        • Microsoft Entra ID
        • Okta
      • Resource organisasi
        • Self-Hosted Runner
  • Apidog Europe
    • Apidog Europe
  • Penagihan
    • Ikhtisar
    • Kredit
    • Meningkatkan Paket Anda
    • Metode Pembayaran Alternatif
    • Mengelola Langganan
    • Memindahkan Tim Berbayar ke Organisasi
  • Add-on
    • API Hub
    • Plugin Apidog Intellij IDEA
    • Ekstensi browser
      • Chrome
      • Microsoft Edge
    • Proxy request
      • Proksi Permintaan di Web
      • Proxy Permintaan dalam Dokumen Bersama
      • Proxy Permintaan di Client
  • Data dan keamanan
    • Penyimpanan dan Keamanan Data
    • Privasi dan Keamanan Data Pengguna
    • Perutean Permintaan dan Keamanan Data
  • Referensi
    • Pendekatan API Design-First
    • Ekstensi Spesifikasi OpenAPI Apidog
    • JSONPath
    • XPath
    • Ekspresi Reguler
    • JSON Schema
    • Format File CSV
    • Menginstal Lingkungan Java
    • Lingkungan Deployment Runner
    • Sintaks Markdown Apidog
    • Ekstensi Swagger Apidog
      • Gambaran Umum
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Ekstensi JSON Schema Apidog
      • Ikhtisar
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • Pusat dukungan
    • Apidog Support Center
    • Impor/Ekspor
      • Bagaimana cara mengimpor data API ke Apidog?
      • Bagaimana cara mengimpor cURL di Apidog?
      • Bagaimana cara memigrasikan lingkungan Postman ke Apidog?
      • Bagaimana cara mengelompokkan endpoint secara otomatis saat impor Swagger/OpenAPI?
    • Mengirim request
      • Apakah Apidog mendukung Socket.IO?
      • Mengapa tanda "+" dalam nilai parameter didekodekan sebagai spasi?
      • Bagaimana cara mengirim permintaan di Apidog?
      • Bagaimana cara mengirim permintaan graphQL di Apidog?
      • Bagaimana cara mengirim permintaan gRPC di Apidog?
      • Bagaimana cara mengirim permintaan SOAP/WebService di Apidog?
      • Bagaimana cara mengirim permintaan WebSocket di Apidog?
      • Apakah Apidog mendukung skrip pra-permintaan/pengujian dan aservi dalam API WebSocket?
      • Bagaimana cara mengirim permintaan SSE di Apidog?
      • Bagaimana cara menambahkan header default pada tingkat folder?
      • Apakah Apidog mendukung skrip pra-permintaan/pengujian dan aservi dalam API gRPC?
      • Kesalahan Resolver DNS ELANREFUSED.DNS
      • Mengapa saya mendapatkan kesalahan "socket hang up" saat mengirim permintaan?
      • Memperbaiki error request
        • Memperbaiki Kesalahan read ECONNRESET
        • Memperbaiki Kesalahan ECONNREFUSED
        • Memperbaiki Kesalahan ETIMEDOUT
        • Memperbaiki Kesalahan ENOTFOUND: Couldn't resolve host
        • Memperbaiki Kesalahan ENOTFOUND: getaddrinfo ENOTFOUND www
        • Memperbaiki Kesalahan connect EHOSTUNREACH
    • Mendesain API
      • Bagaimana cara menggunakan variabel dalam path?
      • Dapatkah saya menggunakan komponen respons sebagai respons default?
      • Bagaimana cara memeriksa siapa yang telah memodifikasi endpoint?
      • Bagaimana cara menghapus folder endpoint secara massal di Apidog?
      • Bagaimana cara menambahkan/menghapus prefiks secara massal pada path endpoint?
      • Bagaimana cara memindahkan level Properti di Schema Editor?
      • Jika sebuah properti string memiliki beberapa nilai enumerasi dan digunakan di berbagai lokasi, bagaimana enum ini dapat dirujuk secara konsisten di seluruh bagian?
      • Bagaimana cara mendapatkan ID folder resource Apidog?
      • Bagaimana cara mendapatkan ID folder sumber daya Apidog?
      • Bagaimana cara menggunakan variabel dalam path URL?
      • Apa yang harus saya lakukan jika endpoint, dokumen, atau skenario pengujian tidak sengaja dihapus?
      • Apakah Apidog mendukung kode permintaan untuk endpoint kustom?
      • Bagaimana Cara Mengelompokkan Endpoint Secara Otomatis Saat Mengimpor Swagger/OpenAPI ke Apidog?
      • Bagaimana cara menghasilkan data array yang tidak duplikat dalam respons mock?
      • Mengapa input "#" tidak didukung di path?
    • Debugging API
      • Bagaimana Apidog berintegrasi dengan sistem manajemen kunci pihak ketiga?
      • Mengapa permintaan yang sama berfungsi dengan benar di alat lain (seperti Postman), tetapi tidak di Apidog?
      • Bagaimana cara mengambil nilai variabel dari database di Apidog?
      • Bagaimana memigrasikan lingkungan dari alat lain ke Apidog?
      • Bagaimana melakukan aservi menggunakan skrip di Apidog?
      • JSONPath hanya dapat mengekstrak array. Bagaimana kita dapat mengekstrak satu elemen dari dalam array tersebut di Apidog?
      • Bagaimana mengonfigurasi operasi database di Apidog ketika lingkungan yang berbeda memiliki kredensial akun database yang berbeda?
      • Bagaimana cara mendapatkan URL dasar layanan dalam skrip kustom?
      • Mengapa Apidog melaporkan kesalahan yang melebihi panjang string maksimum Node.js ketika respons API terlalu besar?
      • Berapa batas ukuran untuk pencetakan konsol? Mengapa saya mendapatkan kesalahan saat mencetak file berukuran besar?
      • Bagaimana cara mengatasi kesalahan koneksi database DB2 di Windows?
      • Mengapa Saya Mendapatkan Error NJS-045 Saat Menghubungkan ke Database Oracle di Apidog?
      • Bagaimana Cara Menghasilkan Nilai Dinamis dalam Skrip Kustom Apidog?
      • Mengapa permintaan klien untuk endpoint yang sama berhasil, tetapi terjadi kesalahan saat debugging di sisi web: "Tidak dapat meminta alamat"?
      • Mengapa Apidog melaporkan kesalahan ketika respons terlalu besar?
      • Bagaimana cara menggunakan endpoint perekaman Apidog?
      • Saat mendefinisikan respons endpoint, apakah endpoint diperbolehkan tidak memiliki konten respons?
      • Bagaimana cara mendapatkan baseURL layanan dalam skrip kustom?
      • Bagaimana cara melihat paket asli di Apidog?
      • Mengapa saya melihat galat "Invalid URI xxx" saat membuat permintaan?
      • Bagaimana cara membuat permintaan asinkron dalam skrip Apidog?
      • Mengapa saya melihat pesan "Couldn't resolve host" saat mengirim permintaan?
      • Berapa Batas Ukuran Cetak Konsol? Mengapa Saya Mendapatkan Error Saat Mencetak File Besar?
      • Bagaimana cara mengunggah file pada permintaan endpoint?
      • Apa yang Harus Dilakukan Jika Apidog Mengalami Crash atau Data Respons Tidak Ditampilkan?
      • URI Pengalihan Resmi yang Digunakan oleh Apidog untuk OAuth2.0
    • Data API mock
      • Bagaimana cara melakukan mock API secara otomatis?
      • Apa yang dapat dilakukan oleh mocking Apidog?
      • Bagaimana cara melakukan mock data API tetap di Apidog?
      • Bagaimana cara membuat mock data bersyarat di Apidog?
      • Bagaimana cara mengaktifkan cloud mock di Apidog?
      • Bagaimana cara mengaktifkan mock self-hosted di Apidog?
      • Apakah Apidog mendukung mocking API WebSocket?
      • Mengapa Browser Tidak Mengembalikan Konten Saat Meminta Mock endpoint?
    • Pengujian otomatis
      • Mengapa skenario pengujian berjalan tanpa masalah di klien lokal saya, tetapi terjadi kesalahan saat menjalankannya di Apidog CLI atau runner?
      • Bagaimana cara membuat skenario pengujian di Apidog?
      • Bagaimana cara meneruskan data antar langkah pengujian?
      • Mengapa saya tidak dapat berhasil mereferensikan data pra-langkah?
      • Bagaimana cara menggunakan foreach loop di Apidog?
      • Apa perbedaan antara sinkronisasi data dari endpoint/kasus endpoint?
      • Bagaimana cara menggunakan data pengujian di Apidog?
      • Bagaimana cara mengambil data pengujian dalam skrip di Apidog?
      • Bagaimana cara menjalankan skenario pengujian secara batch di Apidog?
      • Bagaimana cara menjadwalkan tugas pengujian di Apidog?
      • Bagaimana menjalankan pengujian performa di Apidog?
      • Bagaimana cara melihat permintaan dan respons aktual dalam pengujian performa?
      • Bagaimana cara mengekspor laporan pengujian kinerja di Apidog?
      • Bagaimana cara menggunakan hasil kueri database sebagai parameter untuk melakukan perulangan permintaan API?
      • Menangkap dan Memvalidasi Webhook Stripe di ApiDog Selama CI/CD
      • Bagaimana cara mengatasi kesalahan "Error: unable to verify the first certificate on runner"?
      • Kesalahan General Runner Docker Container "Not Found".
      • Bagaimana Cara Mengatur Host Server untuk General Runner di Versi Web Apidog?
      • Mengapa Skenario Pengujian Terjadwal Berakhir dengan 0 Permintaan?
      • Apa yang harus saya lakukan jika parameter unggahan file tidak dapat ditemukan di Runner atau CLI?
      • Bagaimana menggunakan Runner untuk menjalankan skenario pengujian dengan langkah unggah file?
      • Bagaimana cara mengatasi kesalahan "Error: unable to verify the first certificate on runner"?
      • Bagaimana cara mengakses dan mencari log runner untuk mengidentifikasi masalah ketika terjadi masalah pada runner?
      • Apa yang harus saya lakukan jika parameter endpoint berupa file unggahan dan tidak dapat ditemukan di Runner atau CLI?
      • Mengapa Langkah Pengujian Tidak Disinkronkan Secara Otomatis Saat Use Case API Berubah?
      • Mengapa Penggunaan Beberapa Tanda Dolar dalam Dokumen Markdown Menyebabkan Beberapa Konten Tidak Ditampilkan dengan Benar?
      • Apakah Runner yang di-host sendiri menghasilkan laporan pengujian di server setelah menjalankan tugas?
      • Dapatkah saya menambahkan pre/post processor terpadu ke permintaan dalam skenario pengujian?
      • Bagaimana cara menjaga nilai dinamis tetap konsisten selama satu kali proses pengujian otomatis?
    • Publikasikan dokumentasi API
      • Bagaimana cara menyembunyikan semua logo Apidog dalam dokumen yang dipublikasikan?
      • Ketika spesifikasi API diperbarui, apakah dokumentasi API akan berubah?
      • Bagaimana cara membagikan API kepada kolaborator di Apidog?
      • Bagaimana menyesuaikan domain dokumentasi Apidog?
      • Bagaimana cara membuat dokumentasi multi-versi di Apidog?
      • Cakupan berbagi untuk Publish Docs Sites di Apidog
      • Cakupan berbagi untuk daftar Share Doc di Apidog
      • Mengapa Share Docs yang Dipublikasikan Tidak Menampilkan Hostname?
      • Bagaimana Pengguna Dokumentasi Dapat Mengubah URL Dasar dalam Dokumentasi Bersama?
      • Dapatkah saya menduplikasi dokumen Apidog yang telah dipublikasikan untuk digunakan dalam proyek saya sendiri?
      • Cara Membagikan Header (misalnya, Token) di Dokumentasi Online Apidog?
      • Mengapa anggota tim saya tidak dapat menemukan dokumentasi yang telah dipublikasikan?
      • Bagaimana cara memperbaiki kedaluwarsa sertifikat SSL atau kesalahan Cloudflare 526 pada domain kustom saya?
      • SMTP Kustom Berhasil Dikonfigurasi, tetapi Pengguna dalam Daftar Izin Tidak Menerima Email OTP
    • Markdown
      • Bagaimana cara menggunakan kartu untuk menautkan ke berbagai halaman atau endpoint dalam Apidog?
      • Mengapa sebagian konten tidak ditampilkan dengan benar saat menggunakan beberapa simbol $ dalam dokumen Markdown?
      • Cara menggunakan gambar berlatar belakang transparan di Markdown Apidog?
      • Bagaimana cara mengatur lebar kolom tabel Markdown?
      • Bagaimana cara menyisipkan API internal, dokumen, skema data, atau folder ke dalam dokumen Markdown?
      • Bagaimana cara menambahkan tautan ke dokumen atau endpoint dalam sebuah proyek di komponen kartu Apidog?
    • Branch
      • Bagaimana cara mengakses sprint branch?
    • Administrasi
      • Bagaimana cara menginstal klien Apidog secara senyap?
      • Mengapa saya melihat kesalahan 'No Permission' meskipun memiliki akses admin?
      • Bagaimana cara memeriksa nomor versi runner?
      • Apakah Apidog mendukung win7?
      • Mengapa Apidog menampilkan kesalahan "Cannot locate program entry point DiscardVirtualMemory in dynamic link library KERNEL32.dll" setelah instalasi?
      • Perubahan Langganan dan Pengembalian Dana
      • Permintaan Web Berfungsi, Tetapi Aplikasi Mendapatkan "read ECONNRESET"—Mengapa?
      • Mengapa Saya Tidak Dapat Membuka Apidog Setelah Pembaruan Sistem Windows?
      • Mengapa Apidog gagal dibuka setelah pembaruan sistem Windows
    • Penagihan
      • Dapatkah saya menyiapkan akun penagihan terpisah untuk tim saya di Apidog?
      • Masalah Akses Tim & Penagihan di Apidog
      • Anggota tim yang diundang tidak dapat mengakses Apidog.
      • Mentransfer Tim Berbayar Personal ke Organisasi
    • On-premises
      • Manajemen Pengguna dan Akses di Apidog Self-Hosted Versi Enterprise
    • Web dan client
      • Pengunduhan dan Instalasi Versi Desktop Linux
  1. Menggunakan skrip

Memanggil Bahasa Pemrograman Lain

Apidog memungkinkan Anda menjalankan program eksternal (skrip, JAR, biner) dari lingkungan Javascript Anda. Hal ini memungkinkan Anda memanfaatkan kode yang sudah ada dalam bahasa seperti Java, Python, PHP, Go, Shell, dll.
Pemberitahuan Keamanan
Program eksternal berjalan di luar sandbox Apidog dan memiliki akses penuh ke sistem Anda. Pastikan Anda memercayai kode yang Anda jalankan.

Bahasa yang Didukung#

Apidog menyimpulkan perintah eksekusi berdasarkan ekstensi file:
BahasaEkstensiPrefiks Perintah
Java.jarjava -jar
Python.pypython
Node.js.jsnode
PHP.phpphp
Go.gogo run
Shell.shsh
Ruby.rbruby
Lua.lualua

Cara Memanggil Program Eksternal#

1.
Buka Direktori Program Eksternal: Klik ikon folder di editor skrip untuk membuka direktori tempat skrip eksternal Anda harus ditempatkan.
Direktori Program Eksternal
2.
Jalankan melalui Skrip: Gunakan pm.executeAsync untuk memanggil program.

Referensi API#

pm.executeAsync#

filePath string Jalur program eksternal
args string[] Parameter. Saat memanggil metode tertentu dalam paket jar, JSON.stringify akan digunakan untuk konversi. Selain itu, tipe non-string akan dikonversi secara implisit menjadi string.
options Object
command string Perintah eksekusi program eksternal; bagian pertama dari "prefiks perintah" adalah perintah eksekusi. Opsional, nilai default disimpulkan secara otomatis (lihat tabel "prefiks perintah" di atas), dapat dikustomisasi ke program apa pun.
cwd string Direktori kerja subproses. Opsional, default adalah "Direktori Program Eksternal".
env Record<string, string> Variabel lingkungan subproses. Opsional, default adalah {}.
windowsEncoding string Encoding yang digunakan pada sistem Windows. Opsional, default adalah "cp936".
className string Tentukan nama kelas yang akan dipanggil dalam paket jar, misalnya "com.apidog.Utils".
method string Tentukan nama metode yang akan dipanggil dalam paket jar, misalnya "add".
paramTypes string[] Tentukan tipe parameter dari metode yang akan dipanggil dalam paket jar, misalnya ["int", "int"].
Return: Promise<string>
Penggunaan parameter command
Secara default, Apidog menggunakan python untuk menjalankan file .py. Jika python3 sudah terinstal di komputer, command dapat ditentukan sebagai python3.

pm.execute#

Disarankan untuk menggunakan pm.executeAsync sebagai gantinya.
pm.execute(filePath, args, options)
filePath string Jalur program eksternal
args string[] Parameter. Saat memanggil metode tertentu dalam paket jar, JSON.stringify akan digunakan untuk konversi. Selain itu, tipe non-string akan dikonversi secara implisit menjadi string.
options Object
windowsEncoding string Encoding yang digunakan pada sistem Windows. Opsional, default adalah "cp936".
className string Tentukan nama kelas yang akan dipanggil dalam paket jar, misalnya "com.apidog.Utils".
method string Tentukan nama metode yang akan dipanggil dalam paket jar, misalnya "add".
paramTypes string[] Tentukan tipe parameter dari metode yang akan dipanggil dalam paket jar, misalnya ["int", "int"].
Return: string

Eksekusi dan Log#

Saat menjalankan program, perintah yang dieksekusi akan dicetak di konsol (hanya untuk referensi). Jika hasil tidak sesuai harapan, Anda dapat menyalin perintah tersebut dan menempelkannya di Shell/CMD untuk melakukan debug.
Konsol juga akan mencetak "standard output (stdout)" dan "standard error output (stderr)" dari proses yang dijalankan. Konten stdout (tidak termasuk karakter baris baru di akhir) akan menjadi hasil akhir eksekusi.
TIP
Karena alasan historis, pm.execute memperlakukan eksekusi sebagai gagal ketika terdapat konten di stderr. Hal ini menyebabkan beberapa program gagal ketika mengeluarkan peringatan atau pesan kesalahan. pm.executeAsync berubah menggunakan exit code dari proses untuk menentukan apakah eksekusi gagal.

Input dan Output Program Eksternal#

Parameter#

Karena program eksternal yang ditentukan berjalan dengan eksekusi baris perintah, program tersebut hanya dapat memperoleh parameter yang diteruskan melalui argumen baris perintah.
Misalnya, dalam skrip pm.executeAsync('add.js', [2, 3]), perintah yang sebenarnya dieksekusi adalah node add.js 2 3. Untuk mendapatkan parameter dalam skrip eksternal add.js:
TIP
1.
Bahasa pemrograman yang berbeda memiliki cara yang berbeda untuk mendapatkan argumen baris perintah; silakan merujuk ke dokumentasi bahasa yang sesuai.
2.
Tipe argumen baris perintah selalu string, perlu dikonversi berdasarkan tipe aktual.

Nilai Return#

Seperti disebutkan di atas, Apidog menggunakan konten stdout sebagai hasil eksekusi program. Jadi, mencetak konten ke stdout dapat mengembalikan hasil.
Misalnya, dalam skrip const result = await pm.executeAsync('add.js', [2, 3]), hasil dapat dikembalikan dengan:
1.
Bahasa pemrograman yang berbeda memiliki cara yang berbeda untuk mencetak ke stdout; rujuk ke dokumentasi bahasa yang sesuai.
2.
Tipe return adalah string, perlu dikonversi berdasarkan tipe aktual.
3.
Karakter baris baru di akhir hasil akan dipangkas.
4.
Saat memanggil metode tertentu dalam paket jar, nilai return dari metode yang dipanggil akan digunakan sebagai nilai return akhir.

Melempar Kesalahan#

Melempar kesalahan dapat membuat tugas saat ini gagal dan menghentikan eksekusi. Misalnya:
1.
Bahasa pemrograman yang berbeda memiliki cara yang berbeda untuk melempar kesalahan; rujuk ke dokumentasi yang sesuai.
2.
Dalam JavaScript, console.error('Error') hanya mencetak ke stderr alih-alih melempar kesalahan. Pertimbangkan hal ini juga saat menggunakan bahasa lain.

Informasi Debug#

Karena pm.executeAsync menggunakan exit code alih-alih stderr untuk menentukan keberhasilan, stderr dapat digunakan untuk mencetak informasi debug tanpa memengaruhi eksekusi.
Misalnya:
TIP
1.
Hanya pm.executeAsync yang mendukung cara mencetak info debug ini.
2.
Bahasa pemrograman yang berbeda memiliki cara yang berbeda untuk mencetak ke stderr; rujuk ke dokumentasi yang sesuai.

Migrasi dari pm.execute ke pm.executeAsync#

Karena nilai return dari pm.executeAsync adalah tipe Promise, execute tidak dapat langsung diubah menjadi executeAsync. Namun, Anda dapat menggunakan async/await untuk bermigrasi dengan perubahan minimal.
TIP
Apidog versi 2.3.24 atau lebih baru (CLI versi 1.2.38 atau lebih baru) mendukung top-level await.
Langkah-langkah:
1.
Ubah execute menjadi executeAsync
2.
Tambahkan await sebelum pemanggilan fungsi

Memanggil Metode Tertentu dalam Paket .jar#

TIP
Fitur ini memerlukan Apidog versi 2.1.39 atau lebih baru. Fitur ini hanya mendukung pemanggilan jar dengan reflection, bukan jar seperti Spring Boot yang menggunakan reflection runtime internal.
Secara default, memanggil jar akan menjalankan metode main dalam kelas Main. Jika options.className ditentukan, nilai tersebut akan menggantikan perilaku default dan sebagai gantinya memanggil metode yang ditentukan dalam jar.
Memanggil metode tertentu dalam jar berbeda dari program eksternal lainnya. Apidog akan menggunakan executor bawaan untuk menemukan metode dalam jar melalui reflection dan memanggilnya. Jika metode yang dipanggil memiliki nilai return, nilai tersebut akan digunakan sebagai nilai return akhir setelah dikonversi menjadi string. Jika tidak, cara kerjanya sama seperti pemanggilan lainnya, yaitu menggunakan konten stdout sebagai nilai return.
Misalnya:
Perintah yang sebenarnya dieksekusi adalah:
Di mana <app-dist>/assets/JarExecuter-1.1.0-jar-with-dependencies.jar adalah executor bawaan, yang bertanggung jawab untuk menemukan metode com.apidog.Test.combine(String,String) dalam program pengguna ./scripts/jar-1.0-SNAPSHOT.jar melalui reflection, dan memanggilnya dengan parameter (string JSON) "hello" dan "world".
TIP
paramTypes bersifat opsional. Jika tidak ditentukan, tipe akan disimpulkan secara otomatis berdasarkan parameter. Integer disimpulkan sebagai "int", float sebagai "double", boolean sebagai "boolean", string sebagai "String", array disimpulkan berdasarkan elemen pertama, misalnya [3] disimpulkan sebagai "int[]", [3.14] sebagai "double[]", dll.
Jika tipe yang disimpulkan tidak cocok dengan tipe parameter aktual dari metode yang dipanggil, paramTypes perlu ditentukan secara manual.
Nilai yang didukung dalam array paramTypes: "Number"、"int"、"Integer"、"long"、"Long"、"short"、"Short"、"float"、"Float"、"double"、"Double"、"boolean"、"Boolean"、"String"、"Number[]"、"int[]"、"Integer[]"、"long[]"、"Long[]"、"short[]"、"Short[]"、"float[]"、"Float[]"、"double[]"、"Double[]"、"boolean[]"、"Boolean[]"、"String[]"
Jadi, paramTypes pada contoh di atas dapat dihilangkan:

Contoh#

1. Program PHP#

Skrip:
test.php:

2. Program Jar#

Skrip:
com.apidog.utils.jar:

Masalah Umum#

1. Beberapa program memerlukan file konfigurasi proyek dan akan mengalami kesalahan jika tidak ada#

Rust dan Go:
Rust:
could not find `Cargo.toml` in `<...>/ExternalPrograms` or any parent directory
Go:
go.mod file not found in current directory or any parent directory; see 'go help modules'
Solusi: Gunakan pm.executeAsync dan tentukan cwd.

2. MacOS memiliki Python 3 bawaan tetapi tidak memiliki Python 2#

Gunakan pm.executeAsync dan atur command ke "python3".

3. Command xxx not found#

Instal program yang sesuai dan tambahkan direktori yang diperlukan ke PATH sistem. Lihat docs untuk instalasi Java.

4. Memanggil skrip eksternal mencetak karakter acak pada beberapa sistem Windows#

Atur windowsEncoding ke 'utf-8'
Modified at 2026-06-11 10:17:04
Previous
Referensi Skrip Postman
Next
Menggunakan Pustaka JS
Built with