Перейти к содержимому


Команды Api Для Раздела Групп Клиентов

API

  • Авторизуйтесь для ответа в теме
В этой теме нет ответов

#1 support

support

    Активный участник

  • Модераторы
  • 3 683 сообщений
  • ГородМосква

Отправлено 19 Июль 2016 - 21:39

Назад к настройке работы через API

Примеры для сайта 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

)







Темы с аналогичным тегами API

Количество пользователей, читающих эту тему: 0

0 пользователей, 0 гостей, 0 анонимных