Общее

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

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

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

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

result - true/false - успех/неуспех
data - данные по запросу, в случае успеха
errors - ошибки по запросу, в случае неуспеха

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

Коллекция

Для обновления остатков и цен в коллекции сторонний ресурс отправляет 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 используется интерфейс в ЛК на сайте mtgtrade.net (становится доступным после активации услуги)

Заказы

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

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