Как работает
Если вы не разработчик, прочитайте эту статью, она значительно облегчит использование API 2.0.
Вы можете получить список всех групп подписки, которые есть в аккаунте. Это будет полезным для использования с другими методами.
Запрос передаётся методом POST в формате URLencode на адрес: https://username.expertam.ru/api/getalllists, где username — это логин пользователя в системе и его домен 3-его уровня в сервисе Expertam.
В ответ на запрос ваша система получит результат выполнения функции в формате JSON. Например, такой:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 |
{ "error_code": 0, "error_text": "OK", "result": [ { "id": 2086840, "rass_id": 2086840, "rass_name": "1605189997.0025174394", "rass_title": "#27950" }, { "id": 2086838, "rass_id": 2086838, "rass_name": "1605188141.0707471155", "rass_title": "#27952" }, { "id": 2086839, "rass_id": 2086839, "rass_name": "1605188160.9622104559", "rass_title": "#27957" } ], "hash": "019a22abe9024aae827d223ff3be2442" } |
В случае ошибки будут отдаваться стандартные «Ответы API сервиса».
Параметры, передаваемые в запросе
Единственный параметр для этого метода — rpsKey — ключ API; ключ для вашего аккаунта находится в разделе «Интеграция и API», ссылка на раздел находится в футере личного кабинета или вот /shops/setts/apisettings/
Параметры, получаемые в ответе
Вы получите массив result с объектами. Каждый объект — одна группа. Будут перечислены:
- id — id группы — то, что видим в адресной строке личного кабинета при редактировании группы;
- rass_id — совпдаает с предыдущим значением;
- rass_name — api id группы, чаще всего используется в других методах API (при работе с контактами, например);
- rass_title — название группы, как она названа в личном кабинете (в методах API не нужно, но может быть полезно для общего понимания).