Spock is a powerful, easy-to-use tool for inspecting and debugging API requests and webhooks. It provides a simple web interface for creating custom endpoints and examining incoming HTTP requests in real-time.
- Create custom endpoints on the fly
- Inspect all incoming HTTP requests (GET, POST, PUT, DELETE, PATCH)
- View request headers, query parameters, form data, and raw body
- Real-time updates as requests come in
- Easy-to-use web interface
- Support for both HTTP and HTTPS (via ngrok)
-
Clone the repository:
git clone https://github.com/u1i/spock.git
cd spock -
Install the required dependencies:
pip install -r requirements.txt
-
Start the Spock server:
gunicorn --bind 0.0.0.0:8080 wsgi:app
-
Open your web browser and navigate to http://localhost:8080
-
Click "Create New Endpoint" to generate a unique URL for receiving requests
-
Use the generated URL in your API calls or webhook configurations
-
Watch incoming requests appear in real-time on the Spock interface
docker run -d -p 8080:8080 u1ih/spock
To use Spock with HTTPS:
-
Install ngrok from https://ngrok.com/download
-
Start Spock, and set the HTTPS flag
USE_HTTPS=true gunicorn --bind 0.0.0.0:8080 wsgi:app
-
In a new terminal window, run: ngrok http 8080
-
Use the HTTPS URL provided by ngrok for your API calls
Or use caddy & docker-compose.
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE.md file for details.
- Inspired by the need for a simple, self-hosted request inspection tool
- Built with Flask and Bootstrap
- Named after the logical and analytical Vulcan, Mr. Spock, from Star Trek