system.net.httpPost

Description

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.

Syntax

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

Syntax

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

Code Examples
Code Snippet
# 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
Code Snippet
# 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)