Skip to content

ialexpw/BlackHole

Repository files navigation

BlackHole

A simple Request Bin style application that allows you to capture, debug and inspect HTTP requests in a human-readable way. It is especially helpful when creating an application API or developing Webhooks.

BlackHole allows you to capture GET, POST, PUT, PATCH, DELETE and more HTTP requests.

Requirements

BlackHole is lightweight and can be setup within minutes, the only requirements are a webserver and PHP. Both Apache and nginx work without issue and PHP 7+ is recommended. No database is required.

Installation

  1. Clone the repository
  2. Ensure the directory has write access
  3. Click to generate a random url
  4. Send HTTP requests to the given url
  5. Refresh the page to see information about the requests

Screenshot

image

Development

  • Auto refresh the requests coming in
  • An API to view details about bins/holes
  • An API to allow you to create bins/holes
  • Ability to export data that is within a bin/hole
  • Make it easier to change the HTML template if needed

API Endpoints

  • View Details (no HTML): /index.php?api&details=<code> (linked from results page)
  • View Details (with HTML tags): /index.php?api&details=<code>&raw
  • Create New Bin: /index.php?api&create