Files
ChocolateyPackages/EthanBrown.SublimeText2.WebPackages/tools/PackageCache/Http Requester/README.md
2013-04-04 08:54:25 -04:00

78 lines
2.3 KiB
Markdown

***
# SublimeHttpRequester - HTTP client plugin for Sublime Text 2
***
====================
Contact: [braindamageinc@gmail.com](mailto:braindamageinc@gmail.com)
##Summary
Makes HTTP requests using the selected text as URL + headers. Useful for testing REST APIs from Sublime Text 2 editor.
##Update: Added client SSL certificates
##Usage
Select the text that represents an URL. Examples of requests:
http://www.google.com/search?q=test
GET http://www.google.com/search?q=test
www.google.com/search?q=test
If you need to add extra headers just add them below the URL line, one on each line:
www.google.com/search?q=test
Accept: text/plain
Cookie : SOME_COOKIE
Use the right-click context menu command *Http Requester* or the keyboard shortcut *CTRL + ALT + R* ( *COMMAND + ALT + R* on Mac OS X ).
Update: *F5* refreshes last request.
###POST/PUT usage
Just add **POST_BODY:** after any extra headers and the body on the following lines:
POST http://posttestserver.com/post.php
POST_BODY:
this is the body that will be sent via HTTP POST
a second line for body message
If you want to POST form variables:
POST http://posttestserver.com/post.php
Content-type: application/x-www-form-urlencoded
POST_BODY:
variable1=avalue&variable2=1234&variable3=anothervalue
For PUT:
PUT http://yoururl.com/puthere
POST_BODY:
this body will be sent via HTTP PUT
###DELETE usage
Same as HTTP GET:
DELETE http://yoururl.com/deletethis
###Requesting through a proxy
If you need to send the request through a proxy server you can use:
GET www.yourtest.com
USE_PROXY: 127.0.0.1:1234
Where *127.0.0.1* is the proxy server address (IP or URL) followed by the port number. **Warning** : allways append a port number, even if it's *80*
###Using client SSL certificates
If you need client SSL certification you can use:
GET https://yoursecureserver.com
CLIENT_SSL_CERT: certif_file.pem
CLIENT_SSL_KEY: key_file.key
## Installation
Using the Sublime Text 2 Package Control plugin (http://wbond.net/sublime_packages/package_control)
press *CTRL + SHIFT + P* and find **Package Control: Install Package** and press *Enter*.
Find this plugin in the list by name **Http Requester**.
Or git clone to your Sublime Text 2 packages folder directly (usually located at /Sublime Text 2/Packages/).