ПланФикс API user.changeStatus: различия между версиями
Материал из Planfix
Seva (обсуждение | вклад) (Новая страница: «Позволяет установить статус, если передан/задан параметр '''status'''. Если параметр опущен, то ...») |
SliZzzZ (обсуждение | вклад) |
||
| Строка 55: | Строка 55: | ||
== Перейти == | == Перейти == | ||
*[[ПланФикс API:Сотрудники]] | *[[ПланФикс API:Сотрудники]] | ||
*[[Список функций]] | |||
Версия от 12:01, 27 октября 2010
Позволяет установить статус, если передан/задан параметр status. Если параметр опущен, то статус будет поменян на противоположный установленному. Функция доступна пользователю с правами администратор. Формат запроса:
<?xml version="1.0" encoding="UTF-8"?>
<request method="user.changeStatus">
<account></account>
<sid></sid>
<user>
<id></id>
<status></status>
</user>
<signature></signature>
</request>| Название | Тип | Значение | Примечание |
|---|---|---|---|
| id | int | идентификатор пользователя | |
| status | enum | новый статус | необязательный параметр. Список доступных значений смотри в разделе статусы пользователей |
| signature | string(32) | подпись |
В ответе будет передан параметр статус с указанием установленного статуса.
<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
<user>
<id></id>
</user>
</response>| Название | Тип | Значение | Примечание |
|---|---|---|---|
| user.id | int | идентификатор пользователя |
В противном случае будет возвращен ответ с ошибкой:
<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
<code></code>
</response>| Значение code | Расшифровка |
|---|---|
| 0000 | неизвестная ошибка |