Справочный центр Wialon

share_billing_code

Вы можете предоставлять коды активации пользователям, которые находятся ниже в иерархии. Для этого используйте метод user/share_billing_code.

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

Чтобы предоставить код активации, необходимо выполнение следующих условий:

  • У пользователя, которому вы хотите предоставить код, должны быть права дилера.
  • Код не должен быть уже предоставлен пользователю из другой ветви иерархии.
  • Код не должен быть уже назначен какому-либо объекту.

При предоставлении кодов активации учитывайте следующее:

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

  • Нельзя предоставить один и тот же код активации пользователям из разных ветвей иерархии.

  • Если у учетной записи отзываются права дилера, все предоставленные коды активации автоматически отзываются.

Конечная точка

Copied!
svc=user/share_billing_code&params={
    "userId": <long>,
    "code": "<text>"
}

Параметры

Запрос должен содержать следующие параметры:

Параметр Описание
userId ID пользователя, которому нужно предоставить код активации.
code Предоставляемый код активации.

Ответ

Ответ всегда содержит код ошибки и ее причину. В случае успешного выполнения запроса возвращается следующий ответ:

Copied!
{
  "error": 0,
  "reason": "NO_ERROR"
}

В случае неудачного выполнения запроса ответ содержит код ошибки и причину из таблицы ниже, например:

Copied!
{
  "error": 7,
  "reason": "CODE_ALREADY_SHARED"
}

Коды ошибок

Код ошибки Причина Описание
1 INVALID_PARAMS Неверные входные параметры, или код активации не найден.
2 NO_BILLING_BY_CODES Модуль Коды активации не включен.
3 INVALID_SOURCE_USER Недопустимый исходный пользователь: текущий пользователь не найден, не имеет прав дилера или не является владельцем своей учетной записи.
4 TARGET_USER_NO_ACCESS Целевой пользователь находится в иерархии не ниже текущего пользователя.
5 INVALID_TARGET_USER Недопустимый целевой пользователь: пользователь не найден, не имеет прав дилера или не является владельцем своей учетной записи.
6 CODE_NOT_SHARED_WITH_SOURCE Код не предоставлен исходному пользователю.
7 CODE_ALREADY_SHARED Код уже предоставлен целевому пользователю.
8 CODE_ASSIGNED_TO_UNIT Код назначен объекту.
9 INTERNAL_ERROR Внутренняя ошибка.

Если вы заметили ошибку в тексте, пожалуйста, выделите её и нажмите Ctrl+Enter.