User Guide

cfhttp 175
ColdFusion MX:
• Added the charset and firstrowasheaders attributes.
• Changed Secure Sockets Layer (SSL) support: ColdFusion uses the Sun JSSE library, which
supports 128-bit encryption, to support SSL.
Attributes
The following attributes control the HTTP transaction and can be used for all HTTP methods:
Attribute Req/Opt Default Description
url Req Uses the
http
protocol
Address of the resource on the server which will handle the
request. The URL must include the hostname or IP
address.
If you do not specify the transaction protocol (http:// or
https://), ColdFusion defaults to http.
If you specify a port number in this attribute, it overrides
any
port attribute value.
The
cfhttppparam tag URL attribute appends query string
attribute-value pairs to the URL.
port Opt 80 for http
413 for
https
Port number on the server to which to send the request. A
port value in the url attribute overrides this value.
method Opt GET • GET Requests information from the server. Any data
that the server requires to identify the requested
information must be in the URL or in
cfhttp type="URL"
tags.
• POST Sends information to the server for processing.
Requires one or more
cfhttpparam tags. Often used for
submitting form-like data.
• PUT Requests the server to store the message body at
the specified URL. Use this method to send files to the
server.
• DELETE Requests the server to delete the specified
URL.
• HEAD Identical to the GET method, but the server
does not send a message body in the response. Use this
method for testing hypertext links for validity and
accessibility, determining the type or modification time
of a document, or determining the type of server.
• TRACE Requests that the server echo the received
HTTP headers back to the sender in the response body.
Trace requests cannot have bodies. This method
enables the ColdFusion application to see what is being
received at the server, and use that data for testing or
diagnostic information.
• OPTIONS A request for information about the
communication options available for the server or the
specified URL. This method enables the ColdFusion
application to determine the options and requirements
associated with a URL, or the capabilities of a server,
without requesting any additional activity by the server.
proxyServer Opt Host name or IP address of a proxy server to which to send
the request.
proxyPort Opt 80 Port number to use on the proxy server.