WebRequest() の使い方・引数・戻り値（MQL4／MQL5）

WebRequest() とは

Web サーバーに HTTP の GET・POST リクエストを送り、応答を受け取る関数です。外部の API からデータを取ったり、LINE・Discord などに通知を送ったりするときに使います。

WebRequest() の書式と引数

MQL4 の場合MT4

引数の組み合わせが違う 2 通りの書き方があります。

int WebRequest(
   const string method,
   const string url,
   const string cookie,
   const string referer,
   int timeout,
   const char &data[],
   int data_size,
   char &result[],
   string &result_headers
)

int WebRequest(
   const string method,
   const string url,
   const string headers,
   int timeout,
   const char &data[],
   char &result[],
   string &result_headers
)

戻り値（MQL4）

MQL5 の場合MT5

引数の組み合わせが違う 2 通りの書き方があります。

int WebRequest(
   const string method,
   const string url,
   const string cookie,
   const string referer,
   int timeout,
   const uchar &data[],
   int data_size,
   uchar &result[],
   string &result_headers
)

int WebRequest(
   const string method,
   const string url,
   const string headers,
   int timeout,
   const uchar &data[],
   uchar &result[],
   string &result_headers
)

戻り値（MQL5）

WebRequest() の使い方（コード例）

MQL4

char data[], result[];
string headers;
int code = WebRequest("GET", "https://example.com/", "", 5000, data, result, headers);
if(code == -1)
   Print("WebRequest 失敗 error=", GetLastError(), "（URL を許可リストに登録しましたか？）");
else
   Print("HTTP ", code, " ", CharArrayToString(result, 0, 200, CP_UTF8));

MQL5

uchar data[], result[];
string headers;
int code = WebRequest("GET", "https://example.com/", "", 5000, data, result, headers);
if(code == -1)
   Print("WebRequest 失敗 error=", GetLastError(), "（URL を許可リストに登録しましたか？）");
else
   Print("HTTP ", code, " ", CharArrayToString(result, 0, 200, CP_UTF8));

OnTick()・OnStart() などの関数の中に書いて使う例です。MetaEditor でコンパイルできることを確認済みです。

WebRequest() の注意点

• 事前に「ツール」→「オプション」→「エキスパートアドバイザー」で「WebRequest を許可する URL」に URL を登録しておく必要があります。登録していないとエラーになります（MT4 は4060、MT5 は4014）。
• インジケーターでは使えません。EA とスクリプトで使います。ストラテジーテスターでも使えません。
• 応答を待つ間 EA の処理が止まるので、timeout は短めにします。

MQL4 と MQL5 の違い

WebRequest() でよく出るエラー

• MT4エラー4060関数の使用が許可されていない（WebRequest の URL 未登録など）
• MT5エラー4014この場面では使えない関数を呼んだ
• MT5エラー5203WebRequest の HTTP リクエストが失敗した

関連する関数

• SendNotification()スマホの MT4 / MT5 アプリにプッシュ通知を送る
• GetLastError()直前に起きたエラーの番号を取得する

出力・通知・状態の関数一覧

• Print
• PrintFormat
• Comment
• Alert
• SendNotification
• SendMail
• PlaySound
• MessageBox
• GetLastError
• ResetLastError
• Sleep
• GetTickCount
• IsStopped
• IsTradeAllowed
• IsTesting
• MQLInfoInteger
• TerminalInfoInteger
• EventSetTimer
• EventSetMillisecondTimer
• EventKillTimer
• ExpertRemove
• UninitializeReason
• WebRequest

← MQL関数リファレンスで、ほかの関数を探す