Skip to content

๐Ÿ‘ฝ API request builder - A free, fast, and beautiful alternative to Postman https://postwoman.io ๐Ÿ”ฅ

License

Notifications You must be signed in to change notification settings

huluohu/postwoman

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Postwoman.io logo

API request builder - A free, fast, and beautiful alternative to Postman

Helps you create your requests faster, saving you precious time on your development - Subscribe

Travis Build Status GitHub release Website Contributions welcome All Contributors Financial Contributors on Open Collective Donate on PayPal Chat on Telegram Chat on Discord Tweet

Built with โค๏ธŽ by liyasthomas and contributors


Read: Story behind Postwoman, Postwoman v1.0

Chat: Telegram, Discord

Donate: PayPal, Open Collective, Patreon


Screenshot1 Screenshot2

Features โœจ

โค๏ธ Lightweight: Crafted with minimalistic UI design. Simple design is the best design.

  • Faster, lighter, cleaner, minimal & responsive

โšก๏ธ Fast: Send requests and get/copy responses in real-time! Fast software is the best software.

Methods:

  • GET - Retrieve information about the REST API resource
  • HEAD - Retrieve response headers identical to those of a GET request, but without the response body.
  • POST - Create a REST API resource
  • PUT - Update a REST API resource
  • DELETE - Delete a REST API resource or related component
  • OPTIONS - Describe the communication options for the target resource
  • PATCH - Apply partial modifications to a REST API resource

History entries are synced with local session storage

๐ŸŒˆ Make it yours: Customizable combinations for background, foreground and accent colors: because customization === freedom. Customize now โœจ.

Customizations:

  • Choose theme: Kinda Dark (default), Clearly White, Just Black and System theme
  • Choose accent color: Green (default), Yellow, Pink, Red, Purple, Orange, Cyan and Blue
  • Toggle multi-colored frames

Customized themes are also synced with local session storage

๐Ÿ”ฅ PWA: Install as a PWA (100/100 Lighthouse score) on your device.

Features:

๐Ÿš€ Request: Retrieve data from a URL without having to do a full page refresh.

  • Choose method
  • Enter URL
  • Enter Path

Features:

  • Copy/share public "Share URL"
  • Generate request code for JavaScript XHR, Fetch and cURL
  • Copy generated request code to clipboard
  • Import cURL
  • Label requests

๐Ÿ”Œ WebSocket: Establish full-duplex communication channels over a single TCP connection.

  • Send and receive data

๐Ÿ“ก Server Sent Events: Receive a stream of updates from a server over a HTTP connection without resorting to polling.

  • Receive data

๐ŸŒ GraphQL: GraphQL is a query language for APIs and a runtime for fulfilling those queries with your existing data.

  • Set endpoint and get schemas
  • Multi-column docs

๐Ÿ” Authentication: Allows to identify the end user.

Types:

  • None
  • Basic authentication using username and password
  • Token based authentication

๐Ÿ“ข Headers: Describes the format the body of your request is being sent as.

  • Add or remove Header list

๐Ÿ“ซ Parameters: Use request parameters to set varying parts in simulated requests.

๐Ÿ“ƒ Request Body: Used to send and receive data via the REST API.

Options:

  • Set Content Type
  • Add or remove Parameter list
  • Toggle between key-value and RAW input Parameter list

๐Ÿ‘‹ Responses: Contains the status line, headers and the message/response body.

  • Copy response to clipboard
  • Download response to a local file
  • View preview for HTML responses

HTML responses have "Preview HTML" feature

โฐ History: Request entries are synced with local session storage to reuse with a single click.

Fields:

  • Label
  • Timestamp
  • Method
  • Status code
  • URL
  • Path

History entries can be sorted by any fields

Histories can be deleted one-by-one or all together

๐Ÿ“ Collections: Keep your API requests organized with collections and folders. Reuse them with a single click.

Options:

  • Create infinite collections, folders and requests
  • Edit, delete, move, export, import and replace

Export, import and replace collections with JSON files

Collections are synced with local session storage

๐ŸŒ Proxy: Enable Proxy Mode from Settings to access blocked APIs.

Features:

  • Hide your IP address
  • Fixes CORS (Cross Origin Resource Sharing) issues
  • Access APIs served in non-HTTPS (http://, localhost, etc.)

Proxy is hosted by ApolloTV - Privacy policy

๐Ÿ“œ Pre-Request Scripts: Snippets of code associated with a request that are executed before the request is sent.

Use-cases:

  • Including the timestamp in the request headers
  • Sending a random alphanumeric string in the URL parameters

Requests with Pre-Request Scripts are indicated in History entries

โŒจ๏ธ Keyboard Shortcuts: Optimized for efficiency.

Shortcuts:

  • Send Request Ctrl + G
  • Save to Collections Ctrl + S
  • Copy Request Link Ctrl + K
  • Reset Request Ctrl + L

To find out more, please check out Postwoman Wiki.

Demo ๐Ÿš€ Website

https://postwoman.io

Usage ๐Ÿ’ก

  1. Specify your request method
  2. Type in your API URL
  3. Add API path
  4. Send request
  5. Get response!

You're done!

Built with ๐Ÿ”ง

  • Chromium - Thanks for being so fast!
  • HTML - For the web framework
  • CSS - For styling components
  • JavaScript - For magic!
  • Vue - To add to the JavaScript magic!
  • Nuxt - To add to the Vue magic!

Developing ๐Ÿ‘ท

  1. Clone this repo with git.
  2. Install dependencies by running npm install within the directory that you cloned (probably postwoman).
  3. Start the development server with npm run dev.
  4. Open development site by going to http://localhost:3000 in your browser.

Or, with docker-compose:

  1. Clone this repo with git.
  2. Run docker-compose up
  3. Open development site by going to http://localhost:3000 in your browser.

Docker ๐Ÿณ Docker Cloud Build Status

#pull
docker pull liyasthomas/postwoman

#run
docker run -p 3000:3000 liyasthomas/postwoman:latest

#build
docker build -t postwoman:latest

Releasing ๐Ÿท๏ธ

  1. Clone this repo with git.
  2. Install dependencies by running npm install within the directory that you cloned (probably postwoman).
  3. Build the release files with npm run build.
  4. Find the built project in ./dist.

Contributing ๐Ÿฐ

Please read CONTRIBUTING for details on our CODE OF CONDUCT, and the process for submitting pull requests to us.

Continuous Integration ๐Ÿ’š Travis Build Status

We use Travis CI for continuous integration. Check out our Travis CI Status.

Versioning ๐Ÿ”– GitHub release

This project is developed by Liyas Thomas using the Semantic Versioning specification. For the versions available, see the releases on this repository.

Change log ๐Ÿ“

See the CHANGELOG file for details.

Authors ๐Ÿ”ฎ

Lead Developers

Testing and Debugging

Collaborators

Liyas Thomas
Liyas Thomas

๐Ÿ’ป ๐ŸŽจ
John Harker
John Harker

๐Ÿ’ป ๐ŸŽจ
Nicholas La Roux
Nicholas La Roux

๐Ÿ’ป
Thomas Yuba
Thomas Yuba

๐Ÿ’ป
Nick Palenchar
Nick Palenchar

๐Ÿ’ป
Terran Blake
Terran Blake

๐Ÿ’ป
Andrew Bastin
Andrew Bastin

๐Ÿ’ป
Vladislav
Vladislav

๐Ÿ’ป
izerozlu
izerozlu

๐Ÿ’ป
Jacob Anavisca
Jacob Anavisca

๐Ÿ’ป
Nityananda Gohain
Nityananda Gohain

๐Ÿ’ป
Hossein Nedaee
Hossein Nedaee

๐Ÿ’ป
James George
James George

๐Ÿ’ป

See the list of contributors who participated in this project.

Thanks

Code Contributors

This project exists thanks to all the people who contribute. [Contribute].

Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute]

Individuals

Organizations

Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]

License ๐Ÿ“„

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

Acknowledgements ๐Ÿ™

  • Hat tip to anyone whose code was used
  • Inspirations:

Badges

Postwoman

Default

[![Postwoman](https://img.shields.io/badge/Tested_on-Postwoman-252628?logo=Postwoman)](https://postwoman.io)


Postwoman

Success

[![Postwoman](https://img.shields.io/badge/Tested_on-Postwoman-success?logo=Postwoman)](https://postwoman.io)


Postwoman

Critical

[![Postwoman](https://img.shields.io/badge/Tested_on-Postwoman-critical?logo=Postwoman)](https://postwoman.io)


Postwoman

Custom

[![Postwoman](https://img.shields.io/badge/Tested_on-Postwoman-blueviolet?logo=Postwoman)](https://postwoman.io)


Postwoman

Customize

[![Postwoman](https://img.shields.io/badge/your_text-Postwoman-hex_color_code?logo=Postwoman)](https://postwoman.io)


Postwoman.io

Happy Coding โค๏ธŽ

About

๐Ÿ‘ฝ API request builder - A free, fast, and beautiful alternative to Postman https://postwoman.io ๐Ÿ”ฅ

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Vue 79.1%
  • JavaScript 14.3%
  • CSS 6.5%
  • Dockerfile 0.1%