Trải nghiệm khi dùng Hoppscotch
Bạn mở hoppscotch.io, nhập địa chỉ API vào ô URL, chọn phương thức như GET hoặc POST rồi bấm gửi. Phản hồi hiện bên dưới với mã trạng thái, header và nội dung, có thể xem dạng thô hoặc xem trước nếu là JSON, HTML, ảnh. Giao diện gọn, mở nhanh, không cần cài gì.
Khi làm việc nghiêm túc hơn, bạn lưu các request vào collection (bộ sưu tập) và thư mục, dùng biến môi trường để đổi giữa môi trường test và thật. Có thể viết script chạy trước khi gửi, hoặc kiểm tra kết quả sau khi nhận, bằng JavaScript. Đăng nhập thì đồng bộ được giữa các thiết bị và nhóm.
Với công ty muốn giữ dữ liệu trong nội bộ, Hoppscotch cho phép tự cài bản Community Edition bằng Docker. Việc này đòi hỏi biết cấu hình cơ sở dữ liệu và các biến môi trường, nên phù hợp với người có kinh nghiệm quản trị máy chủ hơn là người dùng thông thường.
Tính năng nổi bật
Gửi request nhanh, giao diện nhẹ
Chọn phương thức, nhập URL, bấm gửi. Hỗ trợ GET, POST, PUT, PATCH, DELETE và nhiều phương thức khác, kể cả tự đặt tên phương thức.
Nhiều giao thức
Ngoài REST còn có GraphQL, WebSocket, Server-Sent Events, Socket.IO và MQTT trong cùng một công cụ.
Collection, môi trường và biến
Gom request vào thư mục, dùng biến môi trường để dùng lại giá trị mà không gõ lặp.
Script trước và sau khi gửi
Viết JavaScript để đặt biến hoặc kiểm tra mã trạng thái và nội dung trả về.
Xuất đoạn code gọi API
Sinh code mẫu cho hơn 10 ngôn ngữ và framework, và nhập lệnh cURL có sẵn.
Cài như PWA, desktop hoặc self-host
Dùng trên web, cài như ứng dụng, tải bản desktop hoặc tự dựng máy chủ riêng cho nhóm.
Tận dụng Hoppscotch vào việc gì?
Lập trình viên
Kiểm tra API khi làm website hoặc app
Gọi thử các endpoint backend, xem phản hồi và header để biết API đang trả về gì trước khi viết code gọi thật.
Sinh viên, người mới học lập trình
Học cách API hoạt động
Thử gọi API công khai, thay đổi tham số và đọc phản hồi để hiểu REST và JSON hoạt động ra sao.
Nhóm QA, backend
Kiểm thử API nội bộ của công ty
Tạo collection các request cho từng chức năng và chia sẻ trong team để mọi người dùng chung bộ test.
Người làm automation, bán hàng online
Kết nối thử với dịch vụ bên thứ ba
Thử gọi API của đơn vị vận chuyển hay cổng thanh toán để chắc chắn thông tin gửi đi đúng trước khi tích hợp vào hệ thống.
Cần chuẩn bị gì?
- Dùng bản web chỉ cần trình duyệt hiện đại; bản desktop có cho Windows, Linux và macOS.
- Tự cài (self-host) cần Docker, một cơ sở dữ liệu PostgreSQL và biết cấu hình biến môi trường trong file .env theo tài liệu.
- Kiến thức cơ bản về API, URL, header, JSON để dùng hiệu quả.
- Tài khoản đăng nhập nếu muốn đồng bộ dữ liệu giữa các thiết bị hoặc làm việc nhóm.
Hướng dẫn cài đặt chi tiết
Cài trên Bản web và desktop
Cách nhanh nhất: mở trang chính thức và dùng ngay trên trình duyệt, không cần cài đặt.
https://hoppscotch.ioCách nhanh trên Windows: mở PowerShell và cài bằng winget (trình quản lý ứng dụng có sẵn trên Windows 10/11).
winget install --id "hoppscotch.Hoppscotch" -eTrên macOS đã cài Homebrew: cài bằng một lệnh trong Terminal.
brew install --cask hoppscotchMuốn dùng như một ứng dụng riêng, trình duyệt cho phép cài như PWA, hoặc tải ứng dụng desktop cho Windows, Linux, macOS theo hướng dẫn trong tài liệu.
https://docs.hoppscotch.io/documentation/clients/desktop
Cài trên Self-host (Docker)
Chuẩn bị Docker và một máy chủ PostgreSQL đang chạy (Hoppscotch cần cơ sở dữ liệu này). Tạo file .env ở thư mục làm việc. Lưu ý: giá trị trong .env không được đặt trong dấu nháy kép. DATABASE_URL là chuỗi kết nối PostgreSQL của bạn; DATA_ENCRYPTION_KEY là một khoá dài đúng 32 ký tự do bạn tự tạo. Các địa chỉ dưới đây là ví dụ chạy trên máy cá nhân; khi có tên miền thì thay bằng URL công khai.
DATABASE_URL=CHUOI_KET_NOI_POSTGRES DATA_ENCRYPTION_KEY=KHOA_32_KY_TU WHITELISTED_ORIGINS=http://localhost:3170,http://localhost:3000,http://localhost:3100,app://localhost_3200,app://hoppscotch VITE_BASE_URL=http://localhost:3000 VITE_SHORTCODE_BASE_URL=http://localhost:3000 VITE_ADMIN_URL=http://localhost:3100 VITE_BACKEND_GQL_URL=http://localhost:3170/graphql VITE_BACKEND_WS_URL=ws://localhost:3170/graphql VITE_BACKEND_API_URL=http://localhost:3170/v1Kéo image gộp (All-In-One) chứa cả giao diện, trang quản trị và backend. Docs cũng cho cách chạy ba container riêng (hoppscotch-frontend, hoppscotch-backend, hoppscotch-admin).
docker pull hoppscotch/hoppscotchChạy container. Cổng 3000 là giao diện chính, 3100 là trang quản trị, 3170 là backend.
docker run -p 3000:3000 -p 3100:3100 -p 3170:3170 --env-file .env --restart unless-stopped hoppscotch/hoppscotchChạy migration cơ sở dữ liệu để tạo bảng: tìm ID container bằng docker ps, vào shell của nó rồi chạy lệnh prisma. Nếu thấy lỗi Database migration not found nghĩa là backend khởi động trước khi có bảng; chạy lệnh migrate rồi khởi động lại.
docker ps docker exec -it ID_CONTAINER /bin/sh pnpm exec prisma migrate deployMở trang quản trị ở địa chỉ dưới để thiết lập và đăng nhập, sau đó dùng giao diện chính ở cổng 3000. Docs không nêu quy trình cập nhật trên trang này, nên khi nâng cấp hãy xem tài liệu và sao lưu cơ sở dữ liệu trước. Có thể dùng Kubernetes bằng Helm chart nếu bạn muốn.
http://localhost:3100Các tuỳ chọn khác (desktop app tự host, subpath) xem trang chính thức.
https://docs.hoppscotch.io/documentation/self-host/community-edition/install-and-build
Dùng thử lần đầu
Mở hoppscotch.io, giữ phương thức GET và nhập vào ô URL một API công khai bạn biết, rồi bấm gửi.
Xem phản hồi: mã trạng thái, header và nội dung trả về. Thử chuyển giữa dạng thô và dạng xem trước.
Đổi sang POST, chọn kiểu nội dung JSON và gửi thử một đoạn dữ liệu nhỏ lên API test.
Lưu request vào một collection và tạo một biến môi trường cho địa chỉ gốc của API, để dùng lại cho nhiều request.
Thử tạo đoạn code gọi API từ request vừa làm, hoặc nhập một lệnh cURL có sẵn để chuyển sang Hoppscotch.
Mẹo dùng hay
- Dùng biến môi trường cho token và địa chỉ gốc để không phải sửa từng request khi đổi môi trường.
- Nếu gặp lỗi CORS khi gọi API từ trình duyệt, tài liệu nói có thể dùng chế độ proxy hoặc tiện ích trình duyệt. Hãy cân nhắc quyền riêng tư khi dùng proxy dịch vụ ngoài.
- Dùng collection và thư mục theo từng dự án để team nhìn vào là hiểu ngay.
- Xuất collection ra file để sao lưu hoặc chia sẻ khi chưa đăng nhập đồng bộ.
Lưu ý và hạn chế
- Một số tính năng như SSO nằm trong bản Enterprise, README có chú thích riêng. Bản Community miễn phí có thể không có đủ mọi tính năng đó.
- Tự cài self-host đòi hỏi quản trị cơ sở dữ liệu và bảo mật, không dành cho người chưa quen server.
- Đừng dán token, mật khẩu thật của hệ thống quan trọng vào công cụ hoặc proxy bạn chưa tin tưởng.
Câu hỏi thường gặp
Hoppscotch có miễn phí không?
Có thể dùng miễn phí trên web và tự cài bản Community Edition theo giấy phép MIT. Một số tính năng doanh nghiệp thuộc gói trả phí riêng.
Khác gì Postman?
Cả hai đều dùng để gọi và thử API. Hoppscotch nhẹ, mã nguồn mở, mở trên trình duyệt và tự cài được; Postman có hệ sinh thái lớn hơn. Chọn cái nào tuỳ nhu cầu của nhóm bạn.
Có tiếng Việt không?
README có nhắc hỗ trợ đa ngôn ngữ (i18n) do cộng đồng dịch. Bạn vào phần cài đặt giao diện để xem tiếng Việt đã có chưa, vì mức độ dịch có thể thay đổi.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/hoppscotch/hoppscotch.gitRepo tương tự nên xem
Supabase
supabase / supabase
Nền tảng backend trên Postgres: cơ sở dữ liệu, đăng nhập, lưu file và API tự sinh, thay thế Firebase
NocoDB
nocodb / nocodb
Biến cơ sở dữ liệu thành bảng tính kiểu Airtable: xem, lọc, nhập liệu và chia sẻ mà không cần viết code
n8n
n8n-io / n8n
Tự động hoá công việc bằng sơ đồ kéo thả, nối hơn 1500 ứng dụng và cả AI, tự cài trên máy chủ riêng