Работа с API

API Moguta.CMS позволяет взаимодействовать с магазином разработанном на движке Moguta.CMS из сторонних приложений. Это значит что дргуие приложения, сайты, crm, и тп. могут получить доступ к содержимому  интернет-магазина и производить с ним различные операции. Таким образом сторонние приложения могут создавать и редактировать товары магазина, получать информацию о пользователях и производить другие дейтвия.

Для того чтобы начать работать с API, в панели управления магазина, вам нужно зайти в раздел Настроек, далее в подраздел API. Там вы сможете добавить приложение и сгенерировать для него токен. Токен является опозновательным знаком приложения и позволяет ему получить доступ к магазину, без него доступ к сайту через API запрещен.

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

После того как вы добавили новое приложение в настройках, движок магазина готов к получению запросов из вне.
Мы подготовили php библиотеку для работы с API Moguta.CMS скачать ее можно тут. Пример использования находится в скачанном архиве в файле apiTest.php.

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

Как использовать класс mogutaApi (быстрый старт)

Создадим объект класса, передав в конструктор класса необходимые параметры 'адрес магазина',  'токен', 'секретный ключ':

$api = new mogutaApi('адрес магазина',  'токен', 'секретный ключ');

Отправим на сервер интернет-магазина команду test с произвольным массивом параметров $testParam. Команда test ничего не делает кроме того, что возвращает переданные ей данный назад. 

$testParam = array('111', '222', '333');
$res = $api->run('test', $testParam, true);

Это тестовая функция, если  все сделали правильно, то в ответ получим следующую информацию:

Array (
    [status] => OK
    [response] => Array(
            [0] => 111
            [1] => 222
            [2] => 333
        )

    [error] => 0
    [sign] => 0c71ad47ab03adef0970564abc71426d
    [workTime] => 0 ms
)


Главное поле для работы с API это responce, в нем сервер будет отдавать результат выполнения запрошенной команды.
В случае возникновения ошибки в поле error будет содержаться код ошибки, говорящий о том, что пошло не так. Коды ошибок:

1 - Неверный токен
2 - Ошибка вызова функции
3 - API не настроен

Подробное описание каждого метода для работы с API

Примеры работы с методами API