Важное дополнение к API №2:
Добавление ключей к data -> user + id|login
postSig - HTML-код подписи участника форума.
Три важных примечания:
1. В БД сервиса текст подписи хранится с bbcode, а возвращается в ответах на запросы тексты сообщений с НТМL-конструкциями, на которые заменяются эти bbcode.
2. Возвращаемый НТМL-код текста подписи должен быть в виде строки, т.е. без переносов строк, знаков табуляций и лишних пробелов.
3. Необходимо экранировать двойные кавычки в значении ключа postSig, т.к. JSON обрамляет в них значения в ответах.
ban - 0 если пользователь не заблокирован, иначе 1.
---------------------------
Пакетный запрос к API
В случае если нужно сделать несколько почти одинаковых запросов к API, можно использовать, так называемый, пакетный запрос.
Допустим нужно узнать информацию о 3-ёх участниках форума. Это можно сделав три запроса подряд:
http://forum.mybb.ru/api.php?data=user&id=255&groupId=1&groupTitle=1 http://forum.mybb.ru/api.php?data=user&id=6871&groupId=1&groupTitle=1 http://forum.mybb.ru/api.php?data=user&id=196&groupId=1&groupTitle=1
Результатом каждого запроса соответственно станет информация о номере группы участника и названии группы:
{"groupId":"2","groupTitle":"Администраторы"}
{"groupId":"4","groupTitle":"Пользователи"}
{"groupId":"5","groupTitle":"Старожилы"}
Учитывая, что желательно сократить количество обращений к API (что снизит нагрузку на сервера МуВВ),
можно сделать пакетный запрос к API (что упростит js-скрипт, производящий запросы и увеличит его быстродействие).
А результатом такого запроса будет массив данных. Изменим приведённые выше запросы, на один пакетный:
http://forum.mybb.ru/api.php?data=user&id=255,6871,196&groupId=1&groupTitle=1
Как видно на примере, с помощью аргумента id, передаются через запятую сразу три значения.
Ответ запроса:
[{"groupId":"2","groupTitle":"Администраторы"}, {"groupId":"4","groupTitle":"Пользователи"}, {"groupId":"5","groupTitle":"Старожилы"}]
Пакетные запросы поддерживают следующие армументы:
data -> user + id
data -> user + login
data -> html + topicId