Техническое описание API
После получения от менеджера сайта МеталТорг.Ру секретного ключа возможна работа через API для скачивания ценовых сводок.
Через API в формате JSON можно получить:
- Справочник ценовых сводок [https://api.metaltorg.ru/?dictionary]
- Справочник валют [https://api.metaltorg.ru/?dictionary_currencies]
- Справочник единиц измерения [https://api.metaltorg.ru/?dictionary_measures]
- Справочник типов контрактов [https://api.metaltorg.ru/?dictionary_contracts]
- Ценовую сводку сроком от 5 лет назад по текущее время или за диапазон, который не выходит за пределы 5 лет назад от дня, в который выполняется запрос.
Получение списка ценовых сводок, справочников валют, единиц измерения и типов контрактов производится без предоставления API_KEY в URL,
в справочниках самый основной параметр Id, который затем используется для получения данных по нужной Вам ценовой сводке. Формат люобго справочника:
[
{"Id":"ID1","Name":"Name2"},
...
]
Id - Это ID элемента в справочнике
Name - это символьное значение этого элемента
Получение ценовой сводки:
URL: https://api.metaltorg.ru/?API_KEY={API KEY}&ID={ID сводки}
Опционально Вы можете указать диапазон дат, за которые нужно получить данные:
URL: https://api.metaltorg.ru/?API_KEY={API KEY}&ID={ID сводки}&date_from={Дата1}&date_to={Дата2}
{Дата1} и {Дата2} задаются в формате: DD-MM-YYYY
Фомат ценовых сводок:
"data":[
{
"Group":"Наименование группы в иерархии МеталТорг.Ру"
"Type":"Наименование типа в иерархии МеталТорг.Ру"
"Subtype":"Наименование подтипа в иерархии МеталТорг.Ру"
"Name":"Название сводки"
"PriceType":"Название типа цены, может быть пустой строкой"
"PriceTypeID":"Id из справочника типов цен, может быть пустой строкой"
"ContractTypeName":"Название типа контракта"
"ContractTypeID":"Id из справочника типов контрактов"
"Year":"Год сводки"
"Month":"Месяц сводки"
"Day":"День сводки"
"Time":"Время сводки в формате HH:MM, может быть пустой строкой"
"Region":"Регион, может быть пустой строкой"
"Value":"Значение сводки"
"CurrencyName":"Название валюты, в которой транслируется сводка"
"CurrencyID":"Id из справочника валют"
"MeasureName":"Название единицы измерения, в которой транслируется сводка"
"MeasureID":"Id из справочника единиц измерения"
},
...
]
errors:[
Ошибки, если они возникли, если ошибок нет пустой массив
]
Примеры сводок, доступных для ознакомления, которые доступны без API_KEY:
https://api.metaltorg.ru/?ID=266
https://api.metaltorg.ru/?ID=267
https://api.metaltorg.ru/?ID=268
https://api.metaltorg.ru/?ID=269
Для этих сводок параметры: date_from и date_to применяются.
Внимание!!! Информация предоставляется только для использования во внутренних информационных системах организации-подписчика.
Трансляция информации, полученной по API сторонним потребителям возможна только с письменного разрешения редакции ©
|