![Postwoman.io logo](https://raw.githubusercontent.com/442623641/postwoman/master/static/logo.png)
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
Built with ❤︎ by liyasthomas and contributors
Read: Story behind Postwoman, Postwoman v1.0
Donate: PayPal, Open Collective, Patreon
✨
Features - Faster, lighter, cleaner, minimal & responsive
Methods:
GET
- Retrieve information about the REST API resourceHEAD
- Retrieve response headers identical to those of a GET request, but without the response body.POST
- Create a REST API resourcePUT
- Update a REST API resourceDELETE
- Delete a REST API resource or related componentOPTIONS
- Describe the communication options for the target resourcePATCH
- Apply partial modifications to a REST API resource
History entries are synced with local session storage
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
Features:
- Instant loading with Service Workers
- Offline support
- Low RAM/memory and CPU usage
- Add to Home Screen (button in footer)
- Desktop PWA support (button in footer)
- (full features)
- 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
- Send and receive data
- Receive data
- Set endpoint and get schemas
- Multi-column docs
Types:
- None
- Basic authentication using username and password
- Token based authentication
- Add or remove Header list
Options:
- Set Content Type
- Add or remove Parameter list
- Toggle between key-value and RAW input Parameter list
- Copy response to clipboard
- Download response to a local file
- View preview for HTML responses
HTML responses have "Preview HTML" feature
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
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
Features:
- Hide your IP address
- Fixes CORS (Cross Origin Resource Sharing) issues
- Access APIs served in non-HTTPS (
http://
) - Use custom Proxy URL
Official Postwoman Proxy is hosted by ApolloTV - Privacy policy
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
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.
🚀 ![Website](https://camo.githubusercontent.com/5293358a369452c246ad1f5e004f44433622c6b88893309e79b8a6be1c03c287/68747470733a2f2f696d672e736869656c64732e696f2f776562736974653f75726c3d6874747073253341253246253246706f7374776f6d616e2e696f266c6f676f3d506f7374776f6d616e)
Demo
💡
Usage - Specify your request method
- Type in your API URL
- Add API path
- Send request
- 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 - Clone this repo with git.
- Install dependencies by running
npm install
within the directory that you cloned (probablypostwoman
). - Start the development server with
npm run dev
. - Open development site by going to http://localhost:3000 in your browser.
Or, with docker-compose:
- Clone this repo with git.
- Run
docker-compose up
- Open development site by going to http://localhost:3000 in your browser.
🐳 ![Docker Cloud Build Status](https://camo.githubusercontent.com/37c39aa959b8aa3f456bfab47e914a7f7bb9bdf21228c937d0292bf69051d5d7/68747470733a2f2f696d672e736869656c64732e696f2f646f636b65722f636c6f75642f6275696c642f6c6979617374686f6d61732f706f7374776f6d616e3f6c6f676f3d446f636b6572)
Docker #pull
docker pull liyasthomas/postwoman
#run
docker run -p 3000:3000 liyasthomas/postwoman:latest
#build
docker build -t postwoman:latest
🏷️
Releasing - Clone this repo with git.
- Install dependencies by running
npm install
within the directory that you cloned (probablypostwoman
). - Build the release files with
npm run build
. - 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.
💚 ![Travis Build Status](https://camo.githubusercontent.com/fa5dffbb80b6f59357daf5866b0a3df296b9ad170dd96147e96d509845c08d61/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f636f6d2f6c6979617374686f6d61732f706f7374776f6d616e3f6c6f676f3d547261766973)
Continuous Integration We use Travis CI for continuous integration. Check out our Travis CI Status.
🔖 ![GitHub release](https://camo.githubusercontent.com/367b963af21123d780e22ada60e679431b4616ebced215d32a357aceae93230e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6c6979617374686f6d61732f706f7374776f6d616e2f616c6c3f6c6f676f3d476974487562)
Versioning 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
- Liyas Thomas - Author
- Caneco - Designer
Testing and Debugging
Collaborators
Liyas Thomas |
John Harker |
Nicholas La Roux |
Thomas Yuba |
Nick Palenchar |
Terran Blake |
Andrew Bastin |
Vladislav |
izerozlu |
Jacob Anavisca |
Nityananda Gohain |
Hossein Nedaee |
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
Default
[![Postwoman](https://img.shields.io/badge/Tested_on-Postwoman-252628?logo=Postwoman)](https://postwoman.io)
Success
[![Postwoman](https://img.shields.io/badge/Tested_on-Postwoman-success?logo=Postwoman)](https://postwoman.io)
Critical
[![Postwoman](https://img.shields.io/badge/Tested_on-Postwoman-critical?logo=Postwoman)](https://postwoman.io)
Custom
[![Postwoman](https://img.shields.io/badge/Tested_on-Postwoman-blueviolet?logo=Postwoman)](https://postwoman.io)
Customize
[![Postwoman](https://img.shields.io/badge/your_text-Postwoman-hex_color_code?logo=Postwoman)](https://postwoman.io)