Дерево страниц

ДОСТУПНО В BUSINESS ПОДПИСКЕ

Метод: awardGamificationPoints

Параметры запроса

ПараметрТипОписание
token (обязательный)stringТокен доступа. Вы можете получить токен с помощью запроса
userId (обязательный)stringID пользователя, которому будут начислены баллы
amount (обязательный)stringКоличество баллов для начисления
reason (обязательный)stringПричина начисления баллов

Права пользователя для выполнения запроса

Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками.

Администратор подразделения или пользователь с ролью с индивидуальными настройками могут начислить баллы только пользователям своего подразделения и вложенных в него подразделений. 

Методы добавления и удаления баллов не работают, если у вас ограничен доступ к изменению пользователей (см. Настройки роли). 

Возможные ошибки

ТипОписание
Permission deniedУ пользователя недостаточно прав для изменения пользователей
Wrong parametersНе удалось обработать запрос, т.к. он не включает все нужные параметры или они заданы неверно

 Пример запроса

<?xml version="1.0" encoding="utf-8"?>
  <SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
                     xmlns="https://ispringlearn.com/go/services/api/soap">
    <SOAP-ENV:Body>
      <AwardGamificationPointsRequest>
        <credentials>
          <token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</token>
        </credentials>
        <userId>2c180ffc-8841-11e9-b68a-0242c0a85016</userId>
        <amount>80</amount>
        <reason>Успешное завершение тренинга</reason>
      </AwardGamificationPointsRequest>
    </SOAP-ENV:Body>
  </SOAP-ENV:Envelope>

Пример ответа

<?xml version="1.0" encoding="UTF-8"?>
	<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
		xmlns:ns1="https://ispringlearn.com/go/services/api/soap">
		<SOAP-ENV:Body>
			<ns1:SuccessResult>
				<ns1:success>true</ns1:success>
			</ns1:SuccessResult>
		</SOAP-ENV:Body>
	</SOAP-ENV:Envelope>