Add a note about Content-Type for form submissions

PUBLISHED_FROM=6079258be24fa0255f5a58e4d364be224435394b
This commit is contained in:
Deomid Ryabkov authored and rojer committed 2016-01-11 12:24:39 +03:00
1 parent d9b9d71b2d
commit 5d6eeb5d1d
1 file changed
+9 -3
+9 -3
View File
@@ -1804,15 +1804,21 @@ int mg_http_create_digest_auth_header(char *buf, size_t buf_len,
* Host headers. `extra_headers` is an extra HTTP headers to send, e.g.
* `"User-Agent: my-app\r\n"`.
* If `post_data` is NULL, then GET request is created. Otherwise, POST request
* is created with the specified POST data. Examples:
* is created with the specified POST data. Note that if the data being posted
* is a form submission, the `Content-Type` header should be set accordingly
* (see example below).
*
* Examples:
*
* [source,c]
* ----
* nc1 = mg_connect_http(mgr, ev_handler_1, "http://www.google.com", NULL,
* NULL);
* nc2 = mg_connect_http(mgr, ev_handler_1, "https://github.com", NULL, NULL);
* nc3 = mg_connect_http(mgr, ev_handler_1, "my_server:8000/form_submit/",
* NULL, "var_1=value_1&var_2=value_2");
* nc3 = mg_connect_http(
* mgr, ev_handler_1, "my_server:8000/form_submit/",
* "Content-Type: application/x-www-form-urlencoded\r\n",
* "var_1=value_1&var_2=value_2");
* ----
*/
struct mg_connection *mg_connect_http(struct mg_mgr *mgr,