Http Operations
Version 22.0.8483
Http Operations
Http Operations allow you to send http requests.
The example below uses the httpPost operation in the Post Job Event to send a json payload to the specified url:
<api:info title="After Run" desc="This event is fired after running a job.">
<input name="JobName" required="true" desc="The name of the job being executed." />
<input name="Source" required="true" desc="The name of source connection." />
<input name="Destination" required="true" desc="The name of destination connection." />
<input name="JobStatus" required="true" desc="The status of the completed run."/>
<input name="Query#" required="true" desc="An array containing each query that was executed." />
<input name="QueryStatus#" required="true" desc="An array containing the status of each query that was executed." />
</api:info>
<api:set attr="http.url" value="http://mysite.com/log/"/>
<api:set attr="http.header:name#1" value="Token"/>
<api:set attr="http.header:value#1" value="MyToken"/>
<api:set attr="http.contenttype" value="application/json"/>
<api:set attr="http.postdata">
{
"JobName":"[_input.jobname]",
"Status":"[_input.JobStatus]"
}
</api:set>
<api:call op="httpPost" in="http"/>
Operations
httpGet
Get a document from the Web using the HTTP GET method.
| Required Input Attribute |
Description |
| url |
The URL to retrieve. |
| Optional Input Attribute |
Description |
| timeout |
The timeout, in seconds, for the operation to complete. Zero (0) means no timeout. The default value is ‘60’. |
| cookie:* |
Any cookies to add to the request. |
| user |
The username to authenticate with if the authscheme parameter is set to something other than None. |
| password |
The password to authenticate with if the authscheme parameter is set to something other than None. |
| authscheme |
The authorization mechanism to use. Only relevant if user and password are provided. The allowed values are ‘BASIC, DIGEST, NTLM’. The default value is ‘BASIC’. |
| header:name# |
The name for each custom header to pass with the request. |
| header:value# |
The value for each custom header to pass with the request. |
| ifmodifiedsince |
The if-modified-since date and time to use as a filter for the results retrieved (for example: Sat, 25 Feb 2006 04:11:47 GMT). |
| localfile |
If specified, the results of the GET will be written to this file. |
| logfile |
The full path to a file to log request and response data. Must be used in conjuction with verbosity. |
| verbosity |
The verbosity of the log file, from 1 (least verbose) to 5 (most verbose). |
| Ouptut Attribute |
Description |
| ssl:issuer |
The issuer of the SSL/TLS certificate. |
| ssl:subject |
The subject of the SSL/TLS certificate. |
| http:statuscode |
The HTTP status code returned from the request. |
| http:content |
The content of the HTTP response. |
| cookie:* |
The cookies returned with the response. |
| http:allcookies |
All of the cookies from the response, returned as a single string. |
| header:* |
The headers returned with the response. |
httpPost
Post data to a URL using the HTTP POST method.
| Required Input Attribute |
Description |
| url |
The destination URL. |
| Optional Input Attribute |
Description |
| timeout |
The timeout, in seconds, for the operation to complete. Zero (0) means no timeout. The default value is ‘60’. |
| cookie:* |
Any cookies to add to the request. |
| user |
The username to authenticate with if the authscheme parameter is set to something other than None. |
| password |
The password to authenticate with if the authscheme parameter is set to something other than None. |
| authscheme |
The authorization mechanism to use. Only relevant if user and password are provided. The allowed values are ‘BASIC, DIGEST, NTLM’. The default value is ‘BASIC’. |
| header:name# |
The name for each custom header to pass with the request. |
| header:value# |
The value for each custom header to pass with the request. |
| ifmodifiedsince |
The if-modified-since date and time to use as a filter for the results retrieved (for example: Sat, 25 Feb 2006 04:11:47 GMT). |
| localfile |
If specified, the results of the GET will be written to this file. |
| header:name# |
The name for each custom header to pass with the request. |
| header:value# |
The value for each custom header to pass with the request. |
| paramname# |
The name for each parameter to pass with the request. |
| paramvalue# |
The value for each parameter to pass with the request. |
| postdata |
Data to include in the POST. Use file:// followed by a file path to post the contents of a file. |
| contenttype |
The content type for the POST. The default value is ‘application/x-www-form-urlencoded’. |
| logfile |
The full path to a file to log request and response data. Must be used in conjuction with verbosity. |
| verbosity |
The verbosity of the log file, from 1 (least verbose) to 5 (most verbose). |
| Ouptut Attribute |
Description |
| ssl:issuer |
The issuer of the SSL/TLS certificate. |
| ssl:subject |
The subject of the SSL/TLS certificate. |
| http:statuscode |
The HTTP status code returned from the request. |
| http:content |
The content of the HTTP response. |
| cookie:* |
The cookies returned with the response. |
| http:allcookies |
All of the cookies from the response, returned as a single string. |
| header:* |
The headers returned with the response. |
httpPut
Put a Web document using the HTTP PUT method.
| Required Input Attribute |
Description |
| url |
The destination URL. |
| Optional Input Attribute |
Description |
| timeout |
The timeout, in seconds, for the operation to complete. Zero (0) means no timeout. The default value is ‘60’. |
| cookie:* |
Any cookies to add to the request. |
| user |
The username to authenticate with if the authscheme parameter is set to something other than None. |
| password |
The password to authenticate with if the authscheme parameter is set to something other than None. |
| authscheme |
The authorization mechanism to use. Only relevant if user and password are provided. The allowed values are ‘BASIC, DIGEST, NTLM’. The default value is ‘BASIC’. |
| header:name# |
The name for each custom header to pass with the request. |
| header:value# |
The value for each custom header to pass with the request. |
| ifmodifiedsince |
The if-modified-since date and time to use as a filter for the results retrieved (for example: Sat, 25 Feb 2006 04:11:47 GMT). |
| localfile |
If specified, the results of the GET will be written to this file. |
| header:name# |
The name for each custom header to pass with the request. |
| header:value# |
The value for each custom header to pass with the request. |
| paramname# |
The name for each parameter to pass with the request. |
| paramvalue# |
The value for each parameter to pass with the request. |
| putdata |
Data to include in the PUT. Use file:// followed by a file path to put the contents of a file. |
| contenttype |
The content type for the POST. The default value is ‘text/html’. |
| logfile |
The full path to a file to log request and response data. Must be used in conjuction with verbosity. |
| verbosity |
The verbosity of the log file, from 1 (least verbose) to 5 (most verbose). |
| Ouptut Attribute |
Description |
| ssl:issuer |
The issuer of the SSL/TLS certificate. |
| ssl:subject |
The subject of the SSL/TLS certificate. |
| http:statuscode |
The HTTP status code returned from the request. |
| http:content |
The content of the HTTP response. |
| cookie:* |
The cookies returned with the response. |
| http:allcookies |
All of the cookies from the response, returned as a single string. |
| header:* |
The headers returned with the response. |