Documentation Comments
Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.
Reality V15.0 ()
RHTTP_POST function (DataBasic) (webservices_api_post.htm)
Sends an HTTP POST request. Returns an error string (empty if no error).
RHTTP_POST(request, path, data)
| request | Either an initialised HTTP request (see RHTTP_INIT_REQUEST) or an empty string. |
| path | Path to data on a server (e.g. /index.html). |
| data | Any valid data for the path (delimited either by attribute mark or new line). |
If path is a full URL (that is, starting with http:// and including the host and, optionally, the port) then request can be an empty string ; in this case the request is initialised from the URL. Similarly, if request is an initialised HTTP request, the host (and port) from the URL override the values in the request header.
If path is a simple directory path, request must be an initialised request.
If the request has been used before, path may be relative to the last RHTTP_GET or RHTTP_POST (that is, it does not have to start with "/").
Using RHTTP_POST on an active request returns an error.
RHTTP_POST allows data to be sent to a URL without including it in a query string.
The HTTP header field Content-Length is automatically set to the correct length for the supplied data.