You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Current »

Метод возвращает историю активации серийного номера по строке серийного номера.

Адрес/v1.0/getserialhistory
ТипPOST 
LoginТребуется

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

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

ПараметрОбязательностьОписаниеВозможные значения

serialNumber

ОбязателенСерийный номер


actiondatebegin

Опционален

В ответ будут попадать только события с совпадающим или более поздним временем в Unix time


actiondateend 

ОпционаленВ ответ будут попадать все события с совпадающим или более ранним временем в Unix time

Если параметры actiondatebegin и actiondateend заданы одновременно, будут отобраны события из отрезка времени [actiondatebegin, actiondateend]

actionresult

Опционален

В ответ будут попадать только события, у которых actionResult совпадает с одним из перечисленных значений

value1[,value2,value3,...]

hardwaregroupid

Опционален

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

 

direction

Опционален

Направление сортировки.

По умолчанию используется сортировка asc

  • asc — сортировка от меньшего к большему;
  • desc — сортировка от большего к меньшему

limit

Опционален

Максимальное количество записей, которые можно получить.

По умолчанию равен 100

От 1 до 100 включительно

offset

 

Опционален

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

Записи нумеруются с 0


Пример запроса
https://station.guardant.ru/v1.0/getserialhistory
Пример тела запроса
{
    "serialNumber": "5MiY8Z-CPMKyz-Raaz1R-cYVwWT-ZhJvs9",
	"limit": 1,
    "offset": 0,
    "direction": "asc",
	"actiondatebegin": 1770648310,
	"actiondateend ": 1770658310,
    "actionresult": 0
}

Ответ

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

Пример ответа 
{
    "history": [
        {
            "_id": 104928,
            "action": 1,
            "actiondate": 1770648313,
            "actionresult": 0,
            "activationsconsumed": 1,
            "activationscountcurrent": 18,
            "binding": {
                "CAN_REPLACE_CPU": false,
                "CAN_REPLACE_DVD": false,
                "CAN_REPLACE_FQDN": false,
                "CAN_REPLACE_HDD": false,
                "CAN_REPLACE_IP": false,
                "CAN_REPLACE_MAC": false,
                "CAN_REPLACE_MOTHERBOARD": false,
                "CAN_REPLACE_OS": false,
                "CAN_REPLACE_SID": false,
                "CPU": false,
                "DVD": false,
                "FQDN": false,
                "HDD": true,
                "IP": false,
                "MAC": false,
                "MOTHERBOARD": true,
                "OS": false,
                "SID": false
            },
            "binding_maxhardwarechangenumber": 0,
            "confirmedupdate": true,
            "cpu": "28 51 28 6C BB 67 12 41 96 0C E2 1B DB 7A 46 58 D0 83 18 B1 F3 6C 2E DE 91 69 B9 BE 5C 3A D8 81",
            "customer": {
                "_id": 13489,
                "archivationdate": 0,
                "archived": false,
                "companyname": "",
                "crmid": "123456",
                "description": "",
                "email": "john@mycompany.com",
                "lastname": "Doe",
                "name": "John",
                "phone": "+14155552671",
                "refid": "",
                "status": 0
            },
            "detectedhardware": {
                "CPU": true,
                "DVD": false,
                "FQDN": true,
                "HDD": true,
                "IP": true,
                "MAC": true,
                "MOTHERBOARD": true,
                "OS": true,
                "SID": true
            },
            "dvd": "F5 A5 FD 42 D1 6A 20 30 27 98 EF 6E D3 09 97 9B 43 00 3D 23 20 D9 F0 E8 EA 98 31 A9 27 59 FB 4B",
            "fqdn": "1E B0 CE 18 68 49 CB B4 CC 23 37 36 EC D5 F6 A2 24 0B 56 C0 4D 21 F4 25 3C D5 09 E3 27 64 A5 4E",
            "hardwaredifference": {
                "CPU": false,
                "DVD": false,
                "FQDN": false,
                "HDD": false,
                "IP": false,
                "MAC": false,
                "MOTHERBOARD": false,
                "OS": false,
                "SID": false
            },
            "hdd": "30 05 A9 71 F8 C7 A6 F8 1D 61 B4 4C AE 58 88 94 BA 4C 79 BC CE 59 73 CD C1 C4 BA 71 5F 8B 63 B4",
            "ip": "26 E9 58 44 FD B8 BB 28 E5 67 47 D4 AC 1B BF 2D 6B 1B 66 2D 66 01 DD 39 A7 60 97 86 EA 89 81 CE",
            "locallicensesconsumed": 1,
            "locallicensesremains": 79,
            "mac": "62 40 94 08 4D 9C 8C 5F E5 32 62 2E AA 2F 63 11 E3 02 C0 C8 32 E4 95 CB 68 59 04 01 C9 E7 73 14",
            "mb": "EA 3B 97 70 33 24 3C CC 3F 9F E2 F3 EB 2C 0A ED 14 EE D4 4A 9B 3B 74 55 F1 F5 F4 28 09 4E E8 FD",
            "netlicensesconsumed": 0,
            "netlicensesremains": 0,
            "os": "C1 02 02 5F B9 8B 6C 2E 33 B7 AA 46 2A 56 2D A4 44 4E 30 5D 66 C1 A8 BE EE 14 9C 1C C3 26 21 85",
            "serial": {
                "_id": 96038,
                "activationcount": 1,
                "activationlimit": 1,
                "dongleid": -1370310995,
                "flags": 1,
                "licensecontainerversion": 393218,
                "serialstring": "5MiY8Z-CPMKyz-Raaz1R-cYVwWT-ZhJvs9",
                "status": 0
            },
            "sid": "E5 65 12 05 BE 47 55 38 A4 A8 98 BB 8C 8F A2 FC D7 0C A2 8A 8D C6 23 F1 79 12 4D 1F 9F B9 50 3C",
            "triallicensesconsumed": 0,
            "triallicensesremains": 0
        }
    ]
}

Возможные значения actionresult:

    enum ActionResultCode : int
    {
        Success                                             = 0,  // successful operation
        SerialHasNoActivationsAvailable                     = 1,  // serial activation limit is over
        VendorHasNoActivationTransactionsAvailable          = 2,  // vendor's service transaction limit is over
        VendorHasNoLocalLiceses                             = 3,  // vendor has no local licenses
        UsingServiceGracePeriodIsExhausted                  = 4,  // vendor's grace period for reactivation of before activated serials is over
        VendorHasNoServiceSubscription                      = 5,  // vendor's service subscription is over
        NotEnoughHardware                                   = 9,  // not enough hardware for activation
        VendorHasNoNetLicensesEnough                        = 10, // vendor has no net licenses
        PrepareLicenseError                                 = 13, // internal error that can be raised during license container generation
        NotEhoughMemoryInLicense                            = 14, // internal error that can be raised during license container generation if not enough memory for saving all features
        UnknownError                                        = 666
    };
  • No labels
Если вам нужна помощь, обратитесь по адресу
hotline@guardant.ru