Примеры для сайта site.ru с ключом доступа 1234562f5a3cc1a97f164df9df55d826
Получение списка групп клиентов магазина
http://site.ru/api/v1/client_groups/get_listPOST Data:secret_key=1234562f5a3cc1a97f164df9df55d826Вернёт последние 1000 клиентов магазина
Пример ответа от сервера:
Array ( [status] => ok [data] => Array ( [0] => Array ( [sites_client_group_id] => Array ( [type] => int_unsigned_not_null [edit] => [value] => 152 ) [sites_client_group_parent_id] => Array ( [type] => int_unsigned [edit] => [value] => 148 ) [sites_client_group_name] => Array ( [type] => str [edit] => 1 [value] => Группа клиентов №1 ) [sites_client_group_discount] => Array ( [type] => float_unsigned_not_null [edit] => 1 [value] => 0.00000 ) [sites_client_group_discount_type] => Array ( [type] => int_unsigned [edit] => 1 [value] => 1 ) [sites_client_group_discount_name] => Array ( [type] => str [edit] => 1 [value] => Скидка по группе №1 ) [sites_client_group_is_default] => Array ( [type] => int_unsigned [edit] => 1 [value] => ) [created_at] => Array ( [type] => int_unsigned [edit] => [value] => ) [updated_at] => Array ( [type] => int_unsigned [edit] => [value] => ) ) ) )
Полученный список отсортирован по дате создания, сначала новые, затем старые группы клиентов. По умолчанию на страницу выводится по 1000 клиентов. Данное значение можно изменять с помощью параметра per_page.
Получить последние 10000 клиентов
http://site.ru/api/v1/client_groups/get_listPOST Data:secret_key=1234562f5a3cc1a97f164df9df55d826per_page=10000В результате выполнения операции будет получено 10000 последних групп клиентов. Список аналогичен приведённому выше.
Получение второй страницы списка групп клиентов (с 1001 по 2000)
http://site.ru/api/v1/client_groups/get_listPOST Data:secret_key=1234562f5a3cc1a97f164df9df55d826page=2
Получение второй страницы списка групп клиентов с произвольным числом групп клиентов на страницу
http://site.ru/api/v1/clients/get_listPOST Data:secret_key=1234562f5a3cc1a97f164df9df55d826page=2per_page=10Покажет клиентов с 11 по 20й
Получение данных по одной группе клиентов
Рассмотрим на примере получения данных по группе клиентов, с идентификатором 152:
http://site.ru/api/v1/client_groups/get/152POST Data:secret_key=0837962f5a3cc1a97f164df9df55d826Вернёт данные по клиенту с идентификатором 152
Пример ответа от сервера:
Array ( [status] => ok [data] => Array ( [sites_client_group_id] => Array ( [type] => int_unsigned_not_null [edit] => [value] => 152 ) [sites_client_group_parent_id] => Array ( [type] => int_unsigned [edit] => [value] => 148 ) [sites_client_group_name] => Array ( [type] => str [edit] => 1 [value] => Группа клиентов №1 ) [sites_client_group_discount] => Array ( [type] => float_unsigned_not_null [edit] => 1 [value] => 0.00000 ) [sites_client_group_discount_type] => Array ( [type] => int_unsigned [edit] => 1 [value] => 1 ) [sites_client_group_discount_name] => Array ( [type] => str [edit] => 1 [value] => Скидка по группе №1 ) [sites_client_group_is_default] => Array ( [type] => int_unsigned [edit] => 1 [value] => ) [created_at] => Array ( [type] => int_unsigned [edit] => [value] => ) [updated_at] => Array ( [type] => int_unsigned [edit] => [value] => ) ) )
Создание новой группы клиентов
http://site.ru/api/v1/client_groups/add POST Data:secret_key=0837962f5a3cc1a97f164df9df55d826 form[sites_client_group_name]=Группа №2 form[sites_client_group_discount]=10 form[sites_client_group_discount_type]=1 form[sites_client_group_discount_name]=Скидка по группе клиента №2 form[sites_client_group_is_default]=0Ответ от сервера:
Array ( [status] => ok [data] => Array ( [sites_client_group_id] => Array ( [type] => int_unsigned_not_null [edit] => [value] => 5122 ) [sites_client_group_parent_id] => Array ( [type] => int_unsigned [edit] => [value] => ) [sites_client_group_name] => Array ( [type] => str [edit] => 1 [value] => Группа №2 ) [sites_client_group_discount] => Array ( [type] => float_unsigned_not_null [edit] => 1 [value] => 10.00000 ) [sites_client_group_discount_type] => Array ( [type] => int_unsigned [edit] => 1 [value] => 1 ) [sites_client_group_discount_name] => Array ( [type] => str [edit] => 1 [value] => Скидка по группе клиента №2 ) [sites_client_group_is_default] => Array ( [type] => int_unsigned [edit] => 1 [value] => ) [created_at] => Array ( [type] => int_unsigned [edit] => [value] => 1468952985 ) [updated_at] => Array ( [type] => int_unsigned [edit] => [value] => ) ) )Принимаемые поля:
Обязательные поля:
form[sites_client_group_name] - Название группы клиентов
Не обязательные поля:
form[sites_client_group_discount] - размер скидки
form[sites_client_group_discount_type] - тип скидки (1 - %, 2 - валюта)
form[sites_client_group_discount_name] - Название скидки в заказе.
form[sites_client_group_is_default] - Использовать как группу по умолчанию. 1 - новые клиенты будут автоматически попадать в эту группу. 0 - попасть в группу можно будет только после назначения модератором
Обновление данных группы клиентов
Рассмотрим на примере группы клиентов, с номером 1410968[/font].
Будем изменять название группы клиентов на "Группа №3":
http://site.ru/api/v1/client_groups/update/1410968POST Data:secret_key=0837962f5a3cc1a97f164df9df55d826form[sites_client_group_name]=Группа №3Пример ответа от сервера:
Array ( [status] => ok )