Импорт сделок с помощью веб API

• 1. Адрес сервиса
• 2. Примеры запросов
  • 2.1. application/x-www-form-urlencoded
  • 2.2. application/json
• 2. Примеры ответов
  • 3.1. Пример успешного ответа
  • 3.2. Пример ответа с ошибкой
• 4. Параметры запроса
• 5. HTTP-коды ответов
• 6. Справочник: Коды рынков

1. Адрес сервиса

POST   https://mfd.ru/tradingsignals/deals/import

2. Примеры запросов

Сервис понимает два формата запроса — application/x-www-form-urlencoded и application/json.

Принимаются только POST-запросы. В ответ на GET, PUT и др. возвращается 404 ошибка.

2.1. application/x-www-form-urlencoded

DealDirection=3&DealPrice=169.77&DealSize=1000&ExtRef=3758880&InstrumentName=GAZP&Password=12345&SecBoard=EQBR&StrategyId=1503&Username=manager&X-Requested-With=XMLHttpRequest

2.2. application/json

{
	"DealDirection": 3,
	"DealPrice": 169.77,
	"DealSize": 1000,
	"ExtRef": 3758880,
	"InstrumentName": "GAZP",
	"Password": "12345",
	"SecBoard": "EQBR",
	"StrategyId": 1503,
	"Username": "manager",
	"X-Requested-With": "XMLHttpRequest"
}

3. Примеры ответов

Ответ всегда в формате application/json.

3.1. Пример успешного ответа

{ "d": { "Success": true } }

3.2. Пример ответа с ошибкой

{
	"d":
	{
		"Errors":
		{
			"DealDirection": [ "Поле «DealDirection» обязательно для заполнения." ],
			"DealPrice": [ "Поле «DealPrice» обязательно для заполнения." ]
		},
		"Message": "Ошибка валидации. Поле «DealDirection» обязательно для заполнения. Поле «DealPrice» обязательно для заполнения.",
		"Success": false
	}
}

4. Параметры запроса

Все параметры кроме DealSize и DealAmount являются обязательными.

Размер сделки можно указать либо в лотах (DealSize), либо в штуках (DealAmount). В случае, если ни один из этих двух параметров не указан, или указаны оба одновременно, веб-сервис вернёт ошибку. 

Наименования параметров регистро-независимые, сервис понимает как dealDirection, так и DEALDIRECTION и т.п.

В качестве десятичного разделителя в числах можно указывать как точку, так и запятую.

5. HTTP-коды ответов

Подробное описание ошибки содержится в теле ответа.

6. Справочник: Коды рынков

Коды рынков:

• TQBR — ММВБ Акции
• PSFU — FORTS Фьючерсы

Нотация тикеров: акции — SBER, GAZP, фьючерсы — RTS-9.12 и т.п.