文件 · feat/embeds · swing07 / hoppscotch · GitCode



        Hoppscotch
      
    
      Open source API development ecosystem
    
  
    _{Built with ❤︎ by
      
        contributors}
  
  
Support

  
  Table of contents


Features
Demo
Usage
Built with
Developing
Docker
Releasing
Contributing
Continuous Integration
Changelog
Authors
License


Features

❤️ Lightweight: Crafted with minimalistic UI design.
⚡️ Fast: Send requests and get/copy responses in real-time.
HTTP Methods


GET - Requests retrieve resource information

POST - The server creates a new entry in a database

PUT - Updates an existing resource

PATCH - Very similar to PUT but makes a partial update on a resource

DELETE - Deletes resource or related component

HEAD - Retrieve response headers identical to those of a GET request, but without the response body.

CONNECT - Establishes a tunnel to the server identified by the target resource

OPTIONS - Describe the communication options for the target resource

TRACE - Performs a message loop-back test along the path to the target resource

<custom> - Some APIs use custom request methods such as LIST. Type in your custom methods.

🌈 Make it yours: Customizable combinations for background, foreground and accent colors — customize now.
Theming

Choose theme: System (default), Light, Dark and Black
Choose accent color: Green (default), Teal, Blue, Indigo, Purple, Yellow, Orange, Red and Pink
Distraction free Zen mode

Customized themes are synced with cloud / local session
🔥 PWA: Install as a PWA on your device.

Instant loading with Service Workers
Offline support
Low RAM/memory and CPU usage
Add to Home Screen
Desktop PWA

🚀 Request: Retrieve response from endpoint instantly.

Choose method

Enter URL

Send


Copy/share public "Share URL"
Generate/copy request code snippets for 10+ languages and frameworks
Import cURL

Label requests

🔌 WebSocket: Establish full-duplex communication channels over a single TCP connection.
📡 Server Sent Events: Receive a stream of updates from a server over a HTTP connection without resorting to polling.
🌩 Socket.IO: Send and Receive data with SocketIO server.
🦟 MQTT: Subscribe and Publish to topics of a MQTT Broker.
🔮 GraphQL: GraphQL is a query language for APIs and a runtime for fulfilling those queries with your existing data.

Set endpoint and get schema
Multi-column docs
Set custom request headers
Query schema
Get query response

🔐 Authorization: Allows to identify the end user.

None
Basic
Bearer Token
OAuth 2.0
OIDC Access Token/PKCE

📢 Headers: Describes the format the body of your request is being sent as.
📫 Parameters: Use request parameters to set varying parts in simulated requests.
📃 Request Body: Used to send and receive data via the REST API.

Set Content Type

FormData, JSON and many more
Toggle between key-value and RAW input parameter list

👋 Response: Contains the status line, headers and the message/response body.

Copy response to clipboard
Download response as a file
View response headers
View raw and preview of HTML, image, JSON, XML responses

⏰ History: Request entries are synced with cloud / local session storage to restore with a single click.
📁 Collections: Keep your API requests organized with collections and folders. Reuse them with a single click.

Unlimited collections, folders and requests
Nested folders
Export and import as file or GitHub gist

Collections are synced with cloud / local session storage
🌐 Proxy: Enable Proxy Mode from Settings to access blocked APIs.

Hide your IP address
Fixes CORS (Cross Origin Resource Sharing) issues
Access APIs served in non-HTTPS (http://) endpoints
Use your own Proxy URL

Official proxy server is hosted by Hoppscotch - GitHub - Privacy Policy
📜 Pre-Request Scripts β: Snippets of code associated with a request that are executed before the request is sent.

Set environment variables
Include timestamp in the request headers
Send a random alphanumeric string in the URL parameters
Any JavaScript functions

📄 API Documentation: Create and share dynamic API documentation easily, quickly.

Add your requests to Collections and Folders
Export Collections and easily share your APIs with the rest of your team
Import Collections and Generate Documentation on-the-go

⌨️ Keyboard Shortcuts: Optimized for efficiency.

Read our documentation on Keyboard Shortcuts

🌎 i18n: Experience the app in your own language.
Help us to translate Hoppscotch. Please read TRANSLATIONS for details on our CODE OF CONDUCT, and the process for submitting pull requests to us.
📦 Add-ons: Official add-ons for hoppscotch.


Proxy - A simple proxy server created for Hoppscotch


CLI β - A CLI solution for Hoppscotch


Browser Extensions - Browser extensions that simplifies access to Hoppscotch
 Firefox  |   Chrome

Extensions fixes CORS issues.


Hopp-Doc-Gen - An API doc generator CLI for Hoppscotch


Add-ons are developed and maintained under Hoppscotch Organization.
☁️ Auth + Sync: Sign in and sync your data in real-time.
Sign in with

GitHub
Google
Email

Synchronize your data

History
Collections
Environments
Settings

✅ Post-Request Tests β: Write tests associated with a request that are executed after the request response.

Check the status code as an integer
Filter response headers
Parse the response data
Any JavaScript functions

🌱 Environments : Environment variables allow you to store and reuse values in your requests and scripts.

Unlimited environments and variables
Initialize through pre-request script
Export as / import from GitHub gist


  Use-cases


By storing a value in a variable, you can reference it throughout your request section
If you need to update the value, you only have to change it in one place
Using variables increases your ability to work efficiently and minimizes the likelihood of error


👨‍👩‍👧‍👦 Teams β: Helps you collaborate across your team to design, develop, and test APIs faster.

Unlimited teams
Unlimited shared collections
Unlimited team members
Role-based access control
Cloud sync
Multiple devices

🚚 Bulk Edit: Edit key-value pairs in bulk.

Entries are separated by newline
Keys and values are separated by :

Prepend // to any row you want to add but keep disabled

For more features, please read our documentation.

Demo

hoppscotch.io

Usage


Choose method

Enter URL

Send request
Get response


Built with


HTML

CSS, SCSS, Windi CSS

JavaScript
TypeScript
Vue
Nuxt


Developing


Update .env.example file found in packages/hoppscotch-app with your own keys and rename it to .env.

Sample keys only works with the production build.

Browser based development environment

GitHub codespace
Gitpod


Local development environment


Clone this repo with git.
Install pnpm using npm by running npm install -g pnpm.
Install dependencies by running pnpm install within the directory that you cloned (probably hoppscotch).
Start the development server with pnpm run dev.
Open development site by going to http://localhost:3000 in your browser.


Docker compose


Clone this repo with git.
Run docker-compose up

Open development site by going to http://localhost:3000 in your browser.


Docker

Official container   
docker run --rm --name hoppscotch -p 3000:3000 hoppscotch/hoppscotch:latest

Releasing


Clone this repo with git.
Install pnpm using npm by running npm install -g pnpm.
Install dependencies by running pnpm install within the directory that you cloned (probably hoppscotch).
Build the release files with pnpm run generate.
Find the built project in packages/hoppscotch-app/dist.


Contributing

Please contribute using GitHub Flow. Create a branch, add commits, and open a pull request.
Please read CONTRIBUTING for details on our CODE OF CONDUCT, and the process for submitting pull requests to us.

Continuous Integration

We use GitHub Actions for continuous integration. Check out our build workflows.

Changelog

See the CHANGELOG file for details.

Authors

This project exists thanks to all the people who contribute — make a contribution.

  
License

This project is licensed under the MIT License - see the LICENSE file for details.