This tool allows you to inspect (or "peep at") the RAW HTTP response of a URL. You can build the request using the settings form (including POST variables, user agent etc.). I initially made this tool a couple of years ago, and it continued to be extremely useful, so I improved it over time, and resolved the main bugs. This app is a work in progress, but if I wait till I'm "finished", this code will never get posted - you know how it goes with side-projects. I hope that in the mean time people will find this useful as is.
The user interface is fairly self-explanatory - specify the URL ("http://" is optional), and optionally the Request Settings. Available settings are:
- User agent
- Range (i.e., byte range - if you only want to retrieve a partial file. Note: this only works if the web server supports it - which most do). E.g.: 0 - 29 will download the first 30 bytes of a file.
- Option to use HTTP 1.0 instead of the default HTTP 1.1
- POST variables - manually add key/value entries, or specify RAW post string. (The latter is extremely useful for sending XML to a .NET web service, shown in the screenshot above.)
- Custom headers - specify one per line using standard HTTP syntax (e.g., "Set-Cookie: one=blah").
- Accept (i.e., content-types - most browsers send this so the server knows what content-types the client accepts).
- Follow redirects - if not checked then HTTP redirect responses will not be followed, and you will see the actual redirect response. (Note: if it is checked and a redirect occurs, a message window will be displayed that shows you the end URL that responded.)
Once the response has been fully downloaded, HTTPeep will show you:
- Response HTTP status code & description.
- HTTP raw headers - right click to copy or save.
- Response content - right click to copy or save. If the response content-type is text, it will display here unless it is longer than the
MaxLength property of the
TextBox (currently set to 100,000 characters). So you will need to right-click and save to a file to view the content. If the response content-type is non-text, it also won't display here, and again you can right-click to save the content as a file.
- Bytes downloaded / time / average bytes per second in the status bar.
Edit POST variables
By default, the Raw checkbox is unchecked and you can add POST variables one by one. To edit an existing item, just double click it. To remove an item, select it and hit Delete key. You can save or load the POST variables to a text file. The format of the text file is intentionally simple so that you can easily create one using a text editor:
(Note: I haven't provided for an escape of "[" - so will be a problem if your POST variable starts with this.)
From a technical point of view, there is nothing fancy under the hood. I am simply configuring the properties of a
System.Net.HttpWebRequest object, and calling the
GetResponse() method to return a
HttpWebResponse object. Note that a
CookieContainer is set, and cookies are retained while the app remains open.
The response content is saved to a unique temporary file:
TmpFilename = Path.GetTempPath() + "http_content" + requestStart.Ticks + ".tmp";
The code to download the content stream from the
HttpWebResponse object into a file looks like this:
Stream rcvStream = resp.GetResponseStream();
byte respBytes = new byte;
FileStream fs = new FileStream(TmpFilename, FileMode.Create, FileAccess.Write);
byteCount = rcvStream.Read(respBytes, 0, 256);
fs.Write(respBytes, 0, byteCount);
} while (byteCount > 0);
appSettings keys in the .config file are self-explanatory. All but the first affect the Settings form:
DefaultURL (for the main form)
UserAgentMenu - pipe-delimited list of values (name|string|name|string...). The current UA strings are IE 6, Firefox 1.0, Nokia 6230:
The annoying TextBox BEEP!
Even though Ctrl-C, Ctrl-V, Ctrl-X work by to copy, paste, cut on the standard .NET
TextBox control, Ctrl-A does not select all as you might expect. Instead you get an annoying beep.
So you'd expect a simple solution would work - i.e., code a
KeyUp event handler and set
true so Windows knows you've handled the key-combination. Hmmm... that doesn't work. Guess what? Only setting
e.Handled in the
KeyPress event handler prevents this beep. Unfortunately,
KeyPressEventArgs doesn't give you all the additional info that
KeyEventArgs does so forget putting your code in the
KeyPress event handler. But I wouldn't bother writing all this if I didn't have a solution: just set a flag in the
KeyDown event handler and set
e.Handled in your
KeyPress event handler (which is called after
KeyDown) if the flag is set! Code as follows:
private void TxtUrl_KeyDown(object sender, System.Windows.Forms.KeyEventArgs e)
keyHandled = false;
if (e.KeyValue == 13)
keyHandled = true;
else if (e.Control && e.KeyCode == Keys.A)
keyHandled = true;
private void TxtUrl_KeyPress(object sender, System.Windows.Forms.KeyPressEventArgs e)
e.Handled = true;
Sending XML to a .NET webservice
To get an XML response from a webservice, you can use HTTPeep to POST some XML to your .asmx URL:
- In your web browser, go to your .asmx URL.
- Click on one of the available operations.
- From the SOAP section, copy the SOAPAction line and paste that into the "Custom Headers" textbox on HTTPeep's settings form.
- From the SOAP section, copy the XML for the request, modify the appropriate values, and paste that into the Raw POST textbox on HTTPeep's settings form (make sure "Raw" is checked).
- Paste the .asmx URL into HTTPeep's main form, and click GO. You should then get an XML response (as shown in the main screenshot at the top).
Future improvements / ideas
I have no idea when I'll get around to doing any of these:
- Perform the downloading in a separate thread and provide a Cancel option.
- Redo the user interface - break it up using tabs.
- Don't show "actual returned URL" in a dialog.
- Change default settings from within the app.
- Provide interface to view the contents of the
- Keep a history of previous URLs.
- Provide a way to parse stuff out of the returned HTML - e.g., all form fields, all images etc.
- Let you do a HTTP HEAD request.
- Let you run a regular expression on the response content.
- Provide a way to generate the C# code to make that request.
Feel free to make changes to suit your own requirements.
Ash is a C# developer (MCAD) with a background developing e-commerce and content management solutions. His current role includes working with VOIP systems, integration and maintenance of business and billing apps. His personal projects include the ScrollingGrid web control to enable cross-browser freeze-header 2-way scrolling of DataGrids. His other interests include travel, cinema, Squash, photography, Muay Thai.