Метод добавляет несколько аппаратных ключей к заказу, идентификатор которого передан в параметре пути {id}.

 Заказ должен быть в статусе Подтвержден (Submit). 

Адрес/v1.0/orders/{id}/multipledongles
ТипPOST 
LoginТребуется 

Входные параметры

Входные параметры передаются в теле запроса в raw JSON:  

ПараметрОбязательностьОписаниеВозможные значения
donglesОбязателенМассив, содержащий аппаратные ключи


dongleId

Обязателен

Идентификатор аппаратного ключа  (выгравирован на корпусе).

Добавление аппаратного ключа с dongleId, который совпадает с ранее добавленным в заказ — запрещено


dongleModel

ОбязателенМодель аппаратного ключа

 

publicCode

ОбязателенЧисловое значение публичного кода доступа вендора


typeFlags

ОбязателенПоле Type аппаратного ключа, которые определяет его свойства (поддержку алгоритмов, сетевого функционала и т. п.)

netResource

ОбязателенCетевой ресурс аппаратного ключа
Пример запроса
https://station.guardant.ru/v1.0/orders/1053/multipledongles
Пример тела запроса
{
	"dongles":
	[
		{
		    "dongleId": 995644599,
		    "dongleModel": 2,
		    "netResource": 0,
		    "publicCode": 1368487351,
		    "typeFlags": 442
		},
		{
		    "dongleId": 995644499,
		    "dongleModel": 2,
		    "netResource": 0,
		    "publicCode": 1368487351,
		    "typeFlags": 442
		},
		{
		    "dongleId": 995644399,
		    "dongleModel": 2,
		    "netResource": 0,
		    "publicCode": 1368487351,
		    "typeFlags": 442
		}
	]
}

Ответ

Возвращает массив dongles:

Пример результата запроса 
{
    "dongles": [
        {
            "dongleid": 995644599,
            "model": 2,
            "netresource": 0,
            "publiccode": 1368487351,
            "typeflags": 442,
            "retcode":"10168"
        },
        {
            "dongleid": 995644499,
            "model": 2,
            "netresource": 0,
            "publiccode": 1368487351,
            "typeflags": 442,
            "retcode":"0"
        },
        {
            "dongleid": 995644399,
            "model": 2,
            "netresource": 0,
            "publiccode": 1368487351,
            "typeflags": 442,
            "retcode":"0"
        }
    ]
}

При добавление аппаратного ключа к заказу могут быть получены следующие дополнительные ошибки:

  • ключ не поддерживает ограниченные по времени компоненты (код ошибки 10172);
  • ключ не поддерживает сетевой компонент (код ошибки 10173);
  • общее количество сетевых компонентов превышает сетевой ресурс ключа (код ошибки 10174).

При получении ошибок 10172 и 10173 в ответе на запрос помимо описания ошибки также будут следующе поля: ID аппаратного ключа, номер компонента, номер продукта, номер заказа. Например:

Пример результата запроса с ошибкой 
{
   "conflictedDongleId":999392418,
   "conflictedFeatureNumber":16,
   "conflictedOrderNumber":94,
   "conflictedProductNumber":12350,
   "status":{"code":10172,"description":"Dongle does not support time limited features","message":"Bad Request","status":400}
}

При получении ошибки 10174 в ответе на запрос помимо описания ошибки будет только значение ID аппаратного ключа. 

  • No labels
Если вам нужна помощь, обратитесь по адресу
hotline@guardant.ru