Apa itu httpbin? Endpoint, Cara Menggunakan, dan Alternatif

Jika Anda pernah perlu menguji klien HTTP tanpa menyiapkan backend yang sebenarnya, Anda mungkin pernah menggunakan httpbin. Ini adalah layanan web kecil yang mengulang kembali permintaan Anda kepada Anda, sehingga Anda dapat melihat dengan tepat apa yang dikirimkan oleh kode Anda. Hal ini membuatnya sempurna untuk mendebug header, memeriksa bagaimana klien Anda menangani respons 500, atau memastikan bahwa token otentikasi Anda benar-benar masuk ke dalam permintaan. Anda dapat mengarahkan alat apa pun ke sana, mulai dari perintah curl mentah hingga klien lengkap seperti Apidog. Proyek ini berlokasi di httpbin.org dan merupakan sumber terbuka di bawah lisensi ISC.

Apa itu httpbin?

httpbin adalah layanan permintaan dan respons HTTP. Anda mengirimnya permintaan; ia mengirimkan kembali deskripsi JSON dari permintaan itu. Tidak lebih. Ini dibuat oleh Kenneth Reitz, pengembang di balik pustaka `requests` Python yang populer, dan ditulis dalam Python dengan Flask.

Nilainya terletak pada kesederhanaannya. Katakanlah Anda ingin tahu apakah klien HTTP Anda mengatur header `User-Agent` dengan benar. Anda mengakses `https://httpbin.org/headers` dan responsnya mencantumkan setiap header yang diterima server. Tanpa basis data, tanpa login, tanpa pengaturan. Anda mendapatkan cerminan bersih dari permintaan Anda sendiri.

httpbin.org adalah instansi publik, dan nyaman untuk pemeriksaan cepat. Ia juga bisa lambat atau sebentar tidak tersedia, karena ini adalah layanan bersama gratis. Pemeliharaan telah bergeser selama bertahun-tahun; kode sekarang berada di bawah repositori GitHub `postmanlabs/httpbin`, dengan fork komunitas seperti Kong juga beredar. Untuk apa pun yang sering Anda jalankan, self-hosting adalah pilihan yang lebih aman. Lebih lanjut tentang itu di bawah.

Endpoint httpbin Utama

httpbin mengekspos serangkaian endpoint, masing-masing ditujukan untuk satu jenis pengujian. Berikut adalah yang paling sering Anda gunakan.

Endpoint /status/{codes} dan /delay/{n} adalah pahlawan tanpa tanda jasa di sini. Mereka memungkinkan Anda untuk memaksa jalur kesalahan dan respons lambat sesuai permintaan, yang sulit dipicu terhadap API yang sebenarnya. Jika Anda ingin menghasilkan badan respons palsu daripada gema, pasangkan httpbin dengan API palsu untuk data pengujian.

Cara Menggunakan httpbin untuk Menguji Klien

Cara tercepat untuk mencoba httpbin adalah dengan curl. Kirim permintaan GET dengan parameter kueri:

curl "https://httpbin.org/get?tool=apidog&check=headers"

Anda mendapatkan kembali objek JSON yang menunjukkan `args`, `headers` yang diterima server, dan IP `origin` Anda. Itu menegaskan klien Anda mengirimkan apa yang Anda harapkan.

Untuk menguji bagaimana kode Anda menangani badan POST, kirim beberapa JSON:

curl -X POST "https://httpbin.org/post" \
  -H "Content-Type: application/json" \
  -d '{"name": "widget", "qty": 3}'

httpbin mengulang `json` yang diurai, `data` mentah, dan header, sehingga Anda dapat memverifikasi `Content-Type` dan payload Anda sampai utuh.

Sekarang paksa kesalahan untuk menguji logika percobaan ulang Anda:

curl -i "https://httpbin.org/status/503"

Anda mendapatkan respons `503 Service Unavailable` yang sebenarnya. Arahkan penanganan kesalahan klien Anda ke sini dan konfirmasikan apakah ia mencoba ulang atau gagal dengan anggun. Ganti dengan `/delay/5` untuk mensimulasikan endpoint yang lambat dan periksa pengaturan batas waktu Anda.

Anda tidak harus tetap di terminal. Klien REST apa pun dapat mengakses URL yang sama ini. Jika Anda lebih suka alur kerja grafis, tempelkan `https://httpbin.org/get` ke Apidog, kirim permintaannya, dan periksa respons dengan penyorotan sintaks, riwayat yang disimpan, dan variabel lingkungan. Ini berguna ketika Anda ingin membandingkan respons antar lingkungan atau berbagi pengujian dengan rekan tim. Untuk pengaturan yang mengutamakan terminal, lihat klien API REST TUI ini.

Self-hosting httpbin dengan Docker

Instansi publik httpbin.org bagus untuk pemeriksaan satu kali, tetapi bisa dibatasi laju atau tidak berfungsi saat Anda membutuhkannya. Menjalankan salinan Anda sendiri memperbaiki itu dan menjaga lalu lintas pengujian Anda tetap pribadi. Gambar Docker resmi menjadikannya pekerjaan dua perintah.

Tarik gambar dan jalankan:

docker pull kennethreitz/httpbin
docker run -p 80:80 kennethreitz/httpbin

Layanan sekarang mendengarkan di port 80. Akses di `http://localhost/get` dan Anda mendapatkan perilaku yang sama dengan situs publik, tanpa latensi jaringan dan tanpa batas laju bersama. Ini adalah pengaturan yang Anda inginkan dalam pipeline CI, di mana keandalan penting dan Anda tidak ingin bergantung pada layanan eksternal. Gambar ini diterbitkan di Docker Hub sebagai kennethreitz/httpbin.

Jika port 80 digunakan di mesin Anda, petakan port host yang berbeda, misalnya `docker run -p 8080:80 kennethreitz/httpbin`, lalu gunakan `http://localhost:8080/get`.

Alternatif httpbin

httpbin melakukan satu hal dengan baik, tetapi bukan satu-satunya pilihan, dan bukan platform pengujian lengkap. Berikut adalah alternatif yang jujur ​​tergantung pada apa yang Anda butuhkan.

Postman Echo. Layanan echo yang di-hosting dengan semangat yang sama dengan httpbin, dijalankan oleh Postman. Anda mengakses `https://postman-echo.com/get` dan permintaan Anda akan dipantulkan kembali. Ini mencakup endpoint GET, POST, otentikasi, dan utilitas. Lihat dokumen Postman Echo untuk daftar lengkapnya. Jika httpbin.org sedang tidak aktif, Echo adalah pengganti yang solid.

Self-hosted httpbin. Seperti yang ditunjukkan di atas, menjalankan gambar Docker memberi Anda endpoint yang sama persis dengan kontrol penuh dan tanpa batasan bersama. Ini adalah pilihan terbaik ketika Anda memerlukan perilaku httpbin di dalam jaringan pribadi atau pekerjaan CI.

Layanan tiruan (Mock services). httpbin mengulang permintaan Anda; itu tidak mengembalikan data domain yang realistis. Ketika Anda membutuhkan respons palsu tetapi terstruktur (daftar pengguna, objek pesanan, hasil yang dipaginasi), gunakan server tiruan sebagai gantinya. Apidog memiliki mocking cerdas bawaan yang menghasilkan respons realistis dari skema Anda, sehingga frontend Anda dapat mengembangkan terhadap sebuah endpoint sebelum backend ada.

Apidog sebagai klien dan lapisan pengujian. httpbin adalah target tempat Anda mengirim permintaan. Apidog adalah alat yang Anda gunakan untuk mengirimnya. Ini adalah klien API dan platform pengujian lengkap: merancang endpoint, mengirim permintaan, menulis pernyataan, merangkai permintaan ke dalam skenario, dan menjalankannya di CI. Anda akan menggunakan Apidog untuk mengakses httpbin, atau untuk menggantikannya setelah kebutuhan Anda melebihi echo sederhana. Keduanya tidak setara; httpbin adalah layanan kecil, Apidog adalah workbench di sekitarnya. Ketika Anda siap untuk beralih dari panggilan curl ad-hoc ke pengujian yang disimpan dan berulang, Apidog memungkinkan Anda mengimpor permintaan yang ada dan menambahkan pernyataan. Untuk survei opsi tanpa instalasi yang lebih luas, lihat alat pengujian API online gratis ini.

FAQ

Apakah httpbin gratis digunakan? Ya. Instansi publik httpbin.org gratis dan tidak memerlukan akun. Sumbernya terbuka di bawah lisensi ISC, jadi Anda juga dapat menjalankannya sendiri tanpa biaya.

Apakah httpbin masih dikelola? Basis kode berada di repositori GitHub postmanlabs/httpbin dan menerima beberapa perhatian yang berkelanjutan, meskipun pemeliharaannya bersifat intermiten. Karena httpbin.org dapat tidak stabil, banyak tim menyimpan salinan Docker yang di-hosting sendiri untuk hal-hal penting.

Bisakah saya menggunakan httpbin untuk menguji webhook? Tidak terlalu. httpbin mengulang permintaan yang Anda kirimkan kepadanya, tetapi tidak akan menerima peristiwa dari pihak ketiga dan meneruskannya ke mesin lokal Anda. Untuk itu, gunakan layanan tunneling atau inspeksi khusus; lihat panduan ini tentang menguji API dan webhook localhost serta pengantar ini tentang cara kerja webhook.

Apa perbedaan antara httpbin dan Postman Echo? Keduanya melakukan hal yang hampir sama: mengulang kembali permintaan HTTP Anda sebagai JSON. httpbin adalah layanan Python dan Flask sumber terbuka asli; Postman Echo adalah layanan yang di-hosting oleh Postman. Pilih mana saja yang aktif dan dapat dijangkau.

Bisakah saya menguji penanganan kesalahan dengan httpbin? Ya. Gunakan ` /status/{code} ` untuk memaksa kode status apa pun, seperti ` /status/500 ` atau ` /status/429 `, dan ` /delay/{n} ` untuk mensimulasikan respons lambat. Ini adalah cara paling bersih untuk melatih logika percobaan ulang dan batas waktu klien Anda.

Kesimpulan

httpbin adalah alat kecil yang tajam: arahkan klien HTTP ke sana dan lihat permintaan Anda terpantul kembali. Gunakan ` /get ` dan ` /post ` untuk mengonfirmasi apa yang Anda kirim, ` /status ` dan ` /delay ` untuk memaksa jalur kesalahan, dan gambar Docker untuk menjalankan salinan pribadi di CI. Ketika Anda membutuhkan lebih dari sekadar gema, gunakan mock realistis, suite pengujian yang disimpan, dan pernyataan.

Di situlah platform lengkap memberikan manfaat. Apidog memberi Anda klien API untuk mengakses httpbin, mocking cerdas untuk menggantikannya, dan pengujian otomatis untuk mengunci perilaku yang baru saja Anda verifikasi. Unduh Apidog dan ubah pemeriksaan httpbin cepat Anda menjadi pengujian yang dapat diulang.