認証 API

MT4 / MT5 側から商品認証を行うための公開 API です。商品 ID、認証方式、認証値、実行コンテキストを送信すると、一致可否とエラーコードを JSON で返します。

HTTP メソッド

POST

パス

/api/v1/auth/verify

疎通確認

GET /api/v1/ping

送信形式

application/json

リクエスト本文

`product_id`、`auth_type`、`credential`、`context` の4ブロックで構成されます。

{
  "product_id": "11111111-2222-3333-4444-555555555555",
  "auth_type": "password",
  "credential": {
    "password": "sample-password"
  },
  "context": {
    "account_mode": "real",
    "account_number": "12345678",
    "broker": "MetaQuotes-Demo",
    "is_test": false,
    "platform": "mt5",
    "symbol": "EURUSD",
    "timeframe": "H1"
  }
}

レスポンス例

成功時は `license` 情報を返し、失敗時は `code` と `message` で原因を返します。

成功時

{
  "success": true,
  "code": 0,
  "message": "",
  "server_time": 1774528496,
  "license": {
    "id": "99999999-aaaa-bbbb-cccc-dddddddddddd",
    "expires_at": 1798761599
  }
}

失敗時

{
  "success": false,
  "code": 301,
  "message": "許可されていない時間軸です。",
  "server_time": 1774528496
}

項目一覧

EA / インジケータ側で合わせるべきキー名と必須条件です。

項目	型	必須	説明
product_id	uuid	必須	商品ごとに発行されるプロダクト ID。
auth_type	password \| account_number	必須	認証方式。
credential.password	string	条件付き必須	auth_type=password のとき送信。
credential.account_number	string	条件付き必須	auth_type=account_number のとき送信。
context.account_mode	demo \| real	必須	実行口座の種別。
context.account_number	string	必須	実行中の口座番号。
context.broker	string \| null	任意	ブローカー名。
context.is_test	boolean	必須	ストラテジーテスター実行かどうか。
context.platform	mt4 \| mt5	必須	実行プラットフォーム。
context.symbol	string	必須	通貨ペア。
context.timeframe	string	必須	時間軸。例: H1, M15。

エラーコード

まず `code` を見て分類し、必要なら `message` を補助情報として扱います。

コード	説明
0	成功
100	プロダクトIDが誤っています。
101	認証情報が一致しません。
201	ライセンスの有効期限が切れています。
202	ライセンスは無効です。
300	許可されていない通貨ペアです。
301	許可されていない時間軸です。
302	デモ口座では使用できません。
303	リアル口座では使用できません。
304	テスターでは使用できません。
429	アクセスが多すぎます。しばらく待ってください。
400	HTTP ステータス。JSON 形式または必須項目が不正です。

連携ファイルと更新履歴を見る