Общее


- Точка входа для запросов: http://api.mtgtrade.net

- Любой запрос к api необходимо подверждать HTTP авторизацией. подробнее

- api отдает данные в формате json

- Ответ api содержит 3 стандартных ключа:


Общая схема взаимодействия

Коллекция

Для обновления остатков и цен в коллекции сторонний ресурс отправляет POST запрос с остатками и ценами по адресу

"POST http://api.mtgtrade.net/user-collection/"
 array 
(
"data" => array //наличие ключа data обязательно
(
0 => array //Массив с данными
(
"external_id" => 123, //идентификатор карты на стороннем ресурсе
"count" => 1, //Количество
"price" => 1000, //Стоимость в руб.
),

1 => array
(
"external_id" => 345,
"count" => 2,
"price" => 2000,
),

2 => array
(
"external_id" => 456,
"count" => 3,
"price" => 3000,
),

),

)

Если карта с external_id отсутствует в БД коллекции mtgtrade.net, api обратится к стороннему ресурсу за информацией о карте.

Для этого совершается POST запрос вида:

 array 
(
"id" => 123, //уникальный идентификатор карты в БД стороннего ресурса
)

В ответ ожидаем получить json строку такого вида (после преобразования):

 array 
(
"card_id" => 2, //id карты на mtgtrade, метод GET http://api.mtgtrade.net/cards/ подробнее
"lang_id" => 2, //id языка карты на mtgtrade, метод GET http://api.mtgtrade.net/lang/ подробнее
"quality_id" => 1, //id качества карты на mtgtrade, метод GET http://api.mtgtrade.net/quality/ подробнее
"foil" => 0, //Признак фойловости, 1 - фойл, 0 -не фойл.
)

После получения неизвестной карты она сохраняется в БД mtgtrade.net и ее остатки обновляются

Адрес получения информации о карте на стороннем ресурсе редактируется в личном кабинете пользователя mtgtrade.net


Заказы

После совершения заказа на сайте mtgtrade.net будет совершен POST запрос к стороннему ресурсу с информацией о заказе

Адрес запросов на стороннем ресурсе редактируется в личном кабинете пользователя mtgtrade.net