Requests is a simple HTTP library for mql4, built for human beings. Requests lib allows you to send HTTP/1.1 requests easily.
Download repo and copy mql_requests/Include/requests.mqh folder to <TERMINAL DIR>/MQL(4/5)/Include
#include <requests/requests.mqh> int OnInit(){ ... Requests requests; Response response = requests.get("https://site.com/some/url?par=foo&par_2=bar"); Print("Response: " + response.text); // Response: some_response_of_url Print("Response parameters: " + response.parameters); // Response query: par=foo&par_2=bar }You can send GET or POST requests:
response = requests.get("https://site.com/some/url?par=foo&par_2=bar"); response = requests.post("https://site.com/some/url", "par=foo&par_2=bar"); // or send() for dynamic define request query string method = "POST"; response = requests.send(method, "https://site.com/some/url", "par=foo&par_2=bar");Using requests.get(), you can use GET-parameter in url and data together. Next examples are equivalent:
response = requests.get("https://site.com/some/url?par=foo&par_2=bar"); response = requests.get("https://site.com/some/url", "par=foo&par_2=bar"); response = requests.get("https://site.com/some/url?par=foo", "par_2=bar"); Print("Response parameters: " + response.parameters); // "Response parameters: par=foo&par_2=bar"You can use array of string for request data:
string array_data[2][2]; array_data[0][0] = "par_1"; array_data[0][1] = "foo"; array_data[1][0] = "par_2"; array_data[1][1] = "bar"; response = requests.get(url, array_data);RequestData request_data; request_data.add("par", "foo"); Requests requests; Response response = requests.get("https://site.com/some/url", request_data); Print("Response: " + response.text); // Response: some_response_of_url Print("Response parameters: " + response.parameters); // Response parameters: par=foo- HTTP connection reuse
- Sending of GET or POST requests
You can define DEBUG_REQUESTS for display more detailed information of usage Requests:
#include "lib/requests.mqh" #define DEBUG_REQUESTS int OnInit(){ Requests requests; Response response = requests.get("https://site.com/some/url", "par=foo&par_2=bar"); Print("Response: " + response.text); }With DEBUG_REQUESTS you will an addition information to journal Terminal/Experts.
RequestData is helper class for simple create request data.
USAGE:
RequestData request_data; request_data.add("par_1", "foo"); request_data.add("par_2", "bar"); Requests requests; Response response = requests.get(url, request_data); Print("Response: " + response.text);You can replace value of pair using the same name in request_data.add():
RequestData request_data; request_data.add("par_1", "foo"); request_data.add("par_2", "bar"); Print(request_data.to_str()); // "par_1=foo&par_2=bar" request_data.add("par_2", "super_bar"); Print(request_data.to_str()); // "par_1=foo&par_2=super_bar"Use request_data.remove() for clear data and fill request_data new data:
RequestData request_data; request_data.add("par_1", "foo"); request_data.add("par_2", "bar"); request_data.add("par_3", "baz"); Print(request_data.to_str()); // "par_1=foo&par_2=bar&par_3=baz" request_data.remove("par_2"); // removes data pair with specific name Print(request_data.to_str()); // "par_1=foo&par_3=baz" request_data.remove(); // removes all data pairs Print(request_data.to_str()); // ""Use static method to_str(string& _data[][]) if you have an array of pairs:
string array_data[2][2]; array_data[0][0] = "par_1"; array_data[0][1] = "foo"; array_data[1][0] = "par_2"; array_data[1][1] = "bar"; Print(RequestData::to_str(array_data)); // "par_1=foo&par_2=bar&par_3=baz"- Copy
mql_requests/Experts/TestRequest.mq4to<TERMINAL DIR>/MQL(4/5)/Experts - Download mql_unit_test and copy
mql_unit_test/Include/unit_test.mqhfolder to<TERMINAL DIR>/MQL(4/5)/Include - Compile
TestRequest.mq4and runTestRequest.ex4in terminal in a window of any trading pair. - Look test result in
<TERMINAL DIR>/Files/TestRequests_unit_test_log.txt
To reporting bugs or suggest improvements, please use the issue tracker.
Thank you very much, that you would like to contribute to mql_requests. Thanks to the present, past and future contributors.
If you think you have discovered a security issue in our code, please do not create issue or raise it in any public forum until we have had a chance to deal with it. For security issues use security@vuspace.pro
- Project's home: https://github.com/vivazzi/mql_requests
- Report bugs and suggest improvements: https://github.com/vivazzi/mql_requests/issues
- Author's site, Artem Maltsev: https://vivazzi.pro
Copyright © 2022 Artem Maltsev and contributors.
MIT licensed.