Programming ColdFusion MX, 2nd Edition

Name

cfhttp

Synopsis

<cfhttp> 
  [<cfhttpparam>]
  ... 
</cfhttp>

Makes an HTTP or HTTPS request and manages any resulting server response.

Attributes

method=" http_method "

Specifies the method for the HTTP operation. Required. The default is Get. Options are:

Delete

Requests that the target server delete the resource specified in the URL attribute. This option is new in ColdFusion MX 6.1.

Get

Retrieves the information from the target server specified in the URL attribute.

Head

Head is identical to Get except that no message body is sent in the response from the server. This method is often used to test the validity of hyperlinks. This option is new in ColdFusion MX 6.1.

Options

Sends a request for information about the communication options available to the server specified in URL without requiring additional action from the server. This option is new in ColdFusion MX 6.1.

Post

Sends information to the target server identified in the URL attribute. Information to be sent is set using one or more cfhttpparam tags.

Put

Sends information to the target server identified in the URL attribute for storage. The Put method is most often used to send files to the server. Put differs from Post in that put specifies a location where data should be stored whereas Post specifies a resource that should handle posted data. This option is new in ColdFusion MX 6.1.

Trace

Useful for testing HTTP operations, Trace instructs the server specified in the URL attribute to loop-back (echo) the original request header ...