system.net.httpPost
Retrieves the document at the given URL using the HTTP POST protocol. If a parameter dictionary argument is specified, the entries in the dictionary will encoded in "application/x-www-form-urlencoded" format, and then posted. You can post arbitrary data as well, but you'll need to specify the MIME type. The document is then returned as a string.
system.net. httpPost( url, postParams )
-
Parameters
String url - The URL to post to.
PyDictionary postParams - A dictionary of name: value key pairs to use as the post data.
-
Returns
String - The content returned for the POST operation.
-
Scope
All
system.net. httpPost( url, contentType, postData, connectTimeout, readTimeout, username, password, headerValues, bypassCertValidation )
-
Parameters
String url - The URL to post to.
String contentType - Optional - The MIME type to use in the HTTP "Content-type" header.
String postData - The raw data to post via HTTP.
Integer connectTimeout - The timeout for connecting to the url. In millis. Default is 10,000.
Integer readTimeout - The read timeout for the get operation. In millis. Default is 60,000.
String username - If specified, the call will attempt to authenticate with basic HTTP authentication.
String password - The password used for basic http authentication, if the username parameter is also present.
PyDictionary headerValues - Optional - A dictionary of name/value pairs that will be set in the http header.
Boolean bypassCertValidation - Optional - If the target address is an HTTPS address, and this parameter is True,the system will bypass all SSL certificate validation. This is not recommended, though is sometimes necessary for self-signed certificates.
-
Returns
String - The content returned for the POST operation.
-
Scope
All
# This code posts a name (first and last) to the post testing page at
# "http://www.snee.com/xml/crud/posttest.cgi", and returns the resulting page
# as a string.
page
=
system.net.httpPost(
"http://www.snee.com/xml/crud/posttest.cgi"
, {
"fname"
:
"Billy"
,
"lname"
:
"Bob"
})
print
page
# This code sends an XML message to a hypothetical URL.
message
=
"<MyMessage><MyElement>here is the element</MyElement></MyMessage>"
system.net.httpPost(
"http://www.posttome.xyz/posthere"
,
"text/xml"
, message)