Difference between revisions of "Http.request"
From ComputerCraft Wiki
(Document parameters, clarify description, remove return value (it DOES NOT return a value!), and remove excessive line breaks in example) |
m (Document asynchrony) |
||
| Line 5: | Line 5: | ||
|api=HTTP | |api=HTTP | ||
|addon=ComputerCraft | |addon=ComputerCraft | ||
| − | |desc=Sends a HTTP request to a website. Returns immediately, with an [[Http success (event)|http_success]] or [[Http failure (event)|http_failure]] event being delivered later to indicate the outcome. Issues a POST request if ''postData'' is provided, or a GET request if it is [[nil]] (or omitted). | + | |desc=Sends a HTTP request to a website, asynchronously. Returns immediately, with an [[Http success (event)|http_success]] or [[Http failure (event)|http_failure]] event being delivered later to indicate the outcome. Issues a POST request if ''postData'' is provided, or a GET request if it is [[nil]] (or omitted). |
|examples= | |examples= | ||
{{Example | {{Example | ||
Revision as of 23:10, 5 May 2013
 Function http.request | |
| Sends a HTTP request to a website, asynchronously. Returns immediately, with an http_success or http_failure event being delivered later to indicate the outcome. Issues a POST request if postData is provided, or a GET request if it is nil (or omitted). | |
| Syntax | http.request(string url[, string postData]) |
| Returns | nil |
| Part of | ComputerCraft |
| API | HTTP |
Examples
 Example | |
| Prints the code of a loading bar program if successful. | |
| Code |
http.request("http://pastebin.com/raw.php?i=Tk19jv43")
local requesting = true
while requesting do
local event, url, sourceText = os.pullEvent()
if event == "http_success" then
local respondedText = sourceText.readAll()
print(respondedText)
requesting = false
elseif event == "http_failure" then
print("Server didn't respond.")
requesting = false
end
end
|
