POST

Name

POST Handler

Description

The POST request is sent to ask a web server to accept sensitive data contained within the request message, usually with the intent of storing the data. A common use of POST is uploading a file or submitting a completed web form. POST requests may also be used when request data would exceed 2,000 characters if constructed as a URL using the GET method. The example below shows the data sent to the server with POST as stored in the body of the request:

• POST /test/demo_form.php HTTP/1.1
  Host: www.apidapter.com
• name1=value1&name2=value2

Some notes on POST requests:

• POST requests are never cached.
• POST requests do not remain in the browser history.
• POST requests cannot be bookmarked.
• POST requests have no restrictions on data length.

Fields

None

Errors

Handler will error if a method other than POST is used.