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

Compare with Current View Page History

Version 1 Next »

Поиск серийных номеров

Для поиска серийного номера достаточно указать один из следующих параметров:

  • серийный номер (полностью или частично),
  • номер лицензии (= DongleId, ID лицензии, ID ключа)
  • данные покупателя (полностью или частично),
    • название компании,
    • имя, 
    • фамилию,
    • email-адрес, 
    • телефон.

Авторизация требуется. Входные параметры RAW JSON:

{
"searchstring": "Lv"
}

POST /v1.0/search/serialnumbers

Для запроса доступна сортировка и пагинация. Доступные поля сортировки: serial (по строке серийного номера). Значения параметров сортировки и пагинации по умолчанию: sortby=serial&direction=asc&offset=0&limit=100.

Для запроса доступна фильтрация по статусу серийного номера: Normal(0), Blocked(1). По умолчанию в запросе выдаются серийные номера с любыми статусами. Примеры использования:

  • указав status=1 - получите серийные номера в статусе Blocked(1) ;
  • указав status=0,1 - получите серийные номера и в статусе Normal(0), и в статусе Blocked(1) .

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

{
    "serialnumbers": [
        {
            "_id": 10176,
            "activationcount": 1,
            "activationlimit": 30,
            "customer": {
                "_id": 246,
                "archivationdate": 0,
                "archived": false,
                "companyname": "",
                "description": "Autocreated from activator info",
                "email": "bma_customer@guardant.ru",
                "lastname": "",
                "name": "bma_customer",
                "phone": "+7(495)555-55-55",
                "status": 0,
                "crmid": "",
                "refid": ""
            },
            "dongleid": -1235188599,
            "licensecontainerversion": 393218,
            "serialstring": "LvHdHH-Ux1VmY-pGKq1y-NEE4pp-8iAAgP",
            "status": 0
        },
        {
            "_id": 10022,
            "activationcount": 0,
            "activationlimit": 3,
            "dongleid": -1989049396,
            "licensecontainerversion": 0,
            "serialstring": "L6Jo6h-KLvZ6M-SzMs3K-64Uggc-7B2ZDG",
            "status": 0
        }
    ]
}


Поиск аппаратных ключей

Для поиска аппаратного ключа достаточно указать один из следующих параметров:

  • идентификатор ключа/лицензии (DongleId)
  • данные покупателя (полностью или частично),
    • название компании,
    • имя, 
    • фамилию,
    • email-адрес, 
    • телефон.

Авторизация требуется. Входные параметры RAW JSON:

{
"searchstring": "baskin"
}

POST /v1.0/search/dongles

Для запроса доступна сортировка и пагинация. По умолчанию результат запроса сортируется по dongleId. Значения параметров сортировки и пагинации по умолчанию: direction=asc&offset=0&limit=100.

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

{
    "dongles": [
        {
            "_id": 6,
            "customer": {
                "_id": 10,
                "archivationdate": 0,
                "archived": false,
                "companyname": "baskin&robings",
                "crmid": "",
                "description": "",
                "email": "dfgsfg@dfg-df.ru",
                "lastname": "cream",
                "name": "ice",
                "phone": "+349534534534",
                "refid": "",
                "status": 0
            },
            "dongleid": 991846791,
            "model": 2,
            "netresource": 0,
            "publiccode": 1368487351,
            "typeflags": 442
        }
    ]
}


Поиск аппаратных ключей и серийных номеров

Для поиска аппаратного ключа достаточно указать один из следующих параметров:

  • идентификатор аппаратного ключа/лицензии (DongleId) (либо идентификатор лицензии серийного номера [= DongleId, ID лицензии, ID ключа])
  • серийный номер (полностью или частично),
  • данные покупателя (полностью или частично),
    • название компании,
    • имя, 
    • фамилию,
    • email-адрес, 
    • телефон.

Авторизация требуется. Входные параметры RAW JSON:

{
"searchstring": "baskin"
}

POST /v1.0/search/donglesandserials

Для запроса доступна сортировка и пагинация. По умолчанию аппаратные ключи (dongles) сортируется по dongleId, а серийные номера (serialnumbers)  - по строке серийного номера. Значения параметров сортировки и пагинации по умолчанию: direction=asc&offset=0&limit=100 - влияют и на сортировку аппаратных ключей и на сортировку серийных номеров.

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

{
    "dongles": [
        {
            "_id": 6,
            "customer": {
                "_id": 10,
                "archivationdate": 0,
                "archived": false,
                "companyname": "baskin&robings",
                "crmid": "",
                "description": "",
                "email": "dfgsfg@dfg-df.ru",
                "lastname": "cream",
                "name": "ice",
                "phone": "+349534534534",
                "refid": "",
                "status": 0
            },
            "dongleid": 991846791,
            "model": 2,
            "netresource": 0,
            "publiccode": 1368487351,
            "typeflags": 442
        }
    ],
    "serialnumbers": [
        {
            "_id": 428,
            "activationcount": 0,
            "activationlimit": 1,
            "customer": {
                "_id": 10,
                "archivationdate": 0,
                "archived": false,
                "companyname": "baskin&robings",
                "crmid": "",
                "description": "",
                "email": "dfgsfg@dfg-df.ru",
                "lastname": "cream",
                "name": "ice",
                "phone": "+349534534534",
                "refid": "",
                "status": 0
            },
            "dongleid": -1175471063,
            "licensecontainerversion": 0,
            "serialstring": "TBSzoc-iQcoCF-Hr11Ba-uVsd45-wcZ1VB",
            "status": 0
        }
    ]
}

Поиск заказов по номеру заказа/номеру продукта/названию продукта/имени покупателя/серийному номеру/ID аппаратного ключа

Авторизация требуется. Входные параметры RAW JSON:

{
"searchstring":"Max",
"allowEmptySearchstring":true // опциональный параметр (по умолчанию false) разрешающий использование пустой строки поиска (в этом случае в результате запроса вернутся все значения). 
}

POST /v1.0/search/orders

Для запроса доступна сортировка и пагинация. Доступные поля сортировки: number (по номеру заказа), sumbmitdate (дате подтверждения заказа). Значения параметров сортировки и пагинации по умолчанию: sortby=number&direction=asc&offset=0&limit=100.

Для запроса доступна фильтрация по статусу заказа: Draft(0), Submit(1), Revoked(2). По умолчанию в запросе выдаются заказы с любыми статусами. Если необходимо выбрать заказы с определенными статусами - перечислите их через запятую в параметре запроса "status". Например, указав status=0,1 - получите только заказы в статусе Draft(0) и Submit(1).

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

"orders": [
{
"_id": 10123,
"activationbirthdate": 1539936112,
"activationdeathdate": 1602277200,
"activationlimit": 1,
"canoverwritecontainer": false,
"customer": {
"_id": 5,
"companyname": "",
"description": "sw",
"email": "de@a",
"lastname": "",
"name": "Max",
"phone": "d",
"status": 1,
"crmid": "",
"refid": ""
},
"customerrequired": true,
"date": 1539936112,
"description": "test_cmpound",
"isdemo": false,
"number": 2,
"quantity": 1,
"status": 1,
"submitdate": 0,
"type": 1,
"crmid": "",
"refid": ""
},
{
"_id": 10082,
"activationbirthdate": 1536314029,
"activationdeathdate": 0,
"activationlimit": 1,
"canoverwritecontainer": false,
"customer": {
"_id": 5,
"companyname": "",
"description": "sw",
"email": "de@a",
"lastname": "",
"name": "Max",
"phone": "d",
"status": 1,
"crmid": "",
"refid": ""
},
"customerrequired": true,
"date": 1536314029,
"description": "1st update for LvHdHH-Ux1VmY-pGKq1y-NEE4pp-8iAAgP",
"isdemo": false,
"number": 1,
"quantity": 1,
"status": 1,
"submitdate": 0,
"type": 1,
"crmid": "",
"refid": ""
}
]

 

Поиск продуктов по номеру/названию

Авторизация требуется. Входные параметры RAW JSON:

{
"searchstring": "2",
"allowEmptySearchstring":true // опциональный параметр (по умолчанию false) разрешающий использование пустой строки поиска (в этом случае в результате запроса вернутся все значения). 
}

POST /v1.0/search/products

Для запроса доступна сортировка и пагинация. Доступные поля сортировки: number (по номеру продукту), name, archivationdate. Значения параметров сортировки и пагинации по умолчанию: sortby=number&direction=asc&offset=0&limit=100.

В данном запросе возможно указать параметр status=draft (status=onsale) для выборки только продуктов в статусе draft (onsale). Если параметр не указан или не совпадает с одним из {draft, onsale}, тогда будут выбраны все продукты, независимо от их статуса.

В запросе имеется опциональный параметр archived=false (archived=true) - для вывода не архивных записей (архивных записей). По умолчанию в запросе выводятся все записи - и архивные и не архивные.

В запросе имеется опциональный параметр licensetype=x,y,.. для фильтрации записей по типу носителя лицензии: программная лицензия (1), аппаратный ключ (2), программная лицензия и аппаратный ключ одновременно (0). В запросе будут выбраны только продукты, предназначенные только для указанных типов носителей лицензии.

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

"products": [
{
"_id": 10046,
"accesscode_id": 4,
"description": "product45",
"flags": 0,
"modification": 0,
"name": "product45",
"productnumber": 45,
"status": 1,
"crmid": "",
"refid": "",
"memoryitems": []
},
{
"_id": 10047,
"accesscode_id": 4,
"description": "product42_1",
"flags": 0,
"modification": 1,
"name": "product42_1",
"productnumber": 42,
"status": 1,
"crmid": "",
"refid": "",
"memoryitems": []
},
{
"_id": 10012,
"accesscode_id": 4,
"description": "pr_1",
"flags": 0,
"modification": 0,
"name": "pr1",
"productnumber": 0,
"status": 1,
"crmid": "",
"refid": "",
"memoryitems": []
}
]

 

Поиск продуктов по покупателю/серийному номеру

Для поиска продуктов достаточно полностью или частично указать один из следующих параметров:

  • имя покупателя,
  • фамилия покупателя,
  • название компании,
  • серийный номер.

Авторизация требуется. Входные параметры RAW JSON:

{
"searchstring": "2"
}

POST /v1.0/search_ext/products

Для запроса доступна сортировка и пагинация. Доступные поля сортировки: number (по номеру продукту), name, archivationdate. Значения параметров сортировки и пагинации по умолчанию: sortby=number&direction=asc&offset=0&limit=100.

В данном запросе возможно указать параметр status=draft (status=onsale) для выборки только продуктов в статусе draft (onsale). Если параметр не указан или не совпадает с одним из {draft, onsale}, тогда будут выбраны все продукты, независимо от их статуса.

В запросе имеется опциональный параметр archived=false (archived=true) - для вывода не архивных записей (архивных записей . По умолчанию в запросе выводятся все записи - и архивные и не архивные.

В запросе имеется опциональный параметр licensetype=X для вывода фильтрации записи по типу носителя лицензии (программная лицензия или аппаратный ключ). Если licensetype=0, то в запросе будут выбраны только продукты, предназначенные и для программных лицензий, и для аппаратных ключей одновременно. Если licensetype=1, то в запросе будут выбраны только продукты, предназначенные и для программных лицензий, и для аппаратных ключей одновременно, а также продукты предназначенные только для программных лицензий.  Если licensetype=2, то в запросе будут выбраны только продукты, предназначенные и для программных лицензий, и для аппаратных ключей одновременно, а также продукты предназначенные только для аппаратных ключей. 

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

"products": [
{
"_id": 10046,
"accesscode_id": 4,
"description": "product45",
"flags": 0,
"modification": 0,
"name": "product45",
"productnumber": 45,
"status": 1,
"crmid": "",
"refid": "",
"memoryitems": [],
"features": [
{
    "_id": 136,
    "archivationdate": 0,
    "archived": false,
    "crmid": "",
    "defaultLicense": {
        "canexclude": true,
        "canmodify": true,
        "consumptionmode": 0,
        "flags": 0,
        "isremote": false,
        "licensingmodel": 1,
        "netlicensescount": 0,
        "rentbegindate": 0,
        "rentdayscount": 0,
        "rentenddate": 0,
        "runcounter": 0
    },
    "description": "f12274",
    "featurenumber": 12274,
    "name": "f12274",
    "pubkey": "61 78 04 38 6F CC 61 9A E3 38 C6 11 12 8A 95 7B B0 A6 1B 41 E4 8D 17 B6 6F AE 1F 03 91 9A 68 88 B7 9A 8E 55 34 57 C4 58",
    "refid": ""
}]},
{
"_id": 10047,
"accesscode_id": 4,
"description": "product42_1",
"flags": 0,
"modification": 1,
"name": "product42_1",
"productnumber": 42,
"status": 1,
"crmid": "",
"refid": "",
"memoryitems": [],
"features": [
{
    "_id": 136,
    "archivationdate": 0,
    "archived": false,
    "crmid": "",
    "defaultLicense": {
        "canexclude": true,
        "canmodify": true,
        "consumptionmode": 0,
        "flags": 0,
        "isremote": false,
        "licensingmodel": 1,
        "netlicensescount": 0,
        "rentbegindate": 0,
        "rentdayscount": 0,
        "rentenddate": 0,
        "runcounter": 0
    },
    "description": "f12274",
    "featurenumber": 12274,
    "name": "f12274",
    "pubkey": "61 78 04 38 6F CC 61 9A E3 38 C6 11 12 8A 95 7B B0 A6 1B 41 E4 8D 17 B6 6F AE 1F 03 91 9A 68 88 B7 9A 8E 55 34 57 C4 58",
    "refid": ""
}]}
]

 

Поиск покупателей по названию компании/имени/фамилии/email/телефону

Авторизация требуется. Входные параметры RAW JSON:

{
"searchstring": "ax",
"allowEmptySearchstring":true // опциональный параметр (по умолчанию false) разрешающий использование пустой строки поиска (в этом случае в результате запроса вернутся все значения). 
}

POST /v1.0/search/customers

Для запроса доступна сортировка и пагинация. Доступные поля сортировки: default (CompanyName,LastName,FirstName), name (LastName,FirstName), company (CompanyName). Значения параметров сортировки и пагинации по умолчанию: sortby=default&direction=asc&offset=0&limit=100.

В данном запросе возможно указать параметр type=company (type=person) для выборки только юридических (физических) лиц. Если параметр не указан или не совпадает с одним из {company, person}, тогда будут выбраны все клиенты (и юр. лица, и физ. лица).

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

"customers": [
{
"_id": 4,
"companyname": "",
"description": "",
"email": "mail@mail.ru",
"lastname": "",
"name": "Petay",
"phone": "8",
"status": 1,
"crmid": "",
"refid": ""
},
{
"_id": 1,
"companyname": "",
"description": "sd",
"email": "qq",
"lastname": "",
"name": "Vasya",
"phone": "qq",
"status": 1,
"crmid": "",
"refid": ""
},
{
"_id": 419,
"companyname": "google",
"description": "omg",
"email": "ar@ae.com",
"lastname": "",
"name": "sidorov",
"phone": "8989",
"status": 1,
"crmid": "",
"refid": ""
}
]

 

Поиск компонентов по номеру/названию

Авторизация требуется. Входные параметры RAW JSON:

{
"searchstring": "71" 
}

POST /v1.0/search/features

Для запроса доступна сортировка и пагинация. Доступные поля сортировки: number, name. Значения параметров сортировки и пагинации по умолчанию: sortby=number&direction=asc&offset=0&limit=100.

В запросе имеется опциональный параметр archived=false (archived=true) - для вывода не архивных записей (архивных записей). По умолчанию в запросе выводятся все записи - и архивные и не архивные.

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

"features": [
{
"_id": 10042,
"description": "feature71",
"featurenumber": 71,
"name": "feature71",
"pubkey":"F9 E5 EC 6B 52 54 BC 80 45 7D 49 BB F0 61 F9 F2 EC AA 9F 63 79 32 0A B6 77 44 8A E7 16 AC C1 82 8A 14 73 1E 56 B6 EF 53"
"crmid": "",
"refid": ""
},
{
"_id": 10043,
"description": "feature72",
"featurenumber": 72,
"name": "feature72",
"pubkey":"11 45 0A B6 77 EC AA 9F 63 79 32 C1 82 8A 14 EC 6B 52 54 BC 80 45 7D 49 BB 73 1E 56 6B 52 54 BC 80 45 7D 34 56 BB AA 99"
"crmid": "",
"refid": ""
},
{
"_id": 10044,
"description": "feature73",
"featurenumber": 73,
"name": "feature73",
"pubkey":"44 8A E7 16 AC EC 6B 52 54 BC 80 45 7D 49 BB 73 1E 56 6B 52 54 BC 80 45 7D 49 BB F0 61 F9 F2 EC AA 9F 63 79 32 0A B6 C3"
"crmid": "",
"refid": ""
}
]

 

Получение истории активации серийного номера

Авторизация требуется. Входные параметры RAW JSON:

{
serialNumber: "LvHdHH-Ux1VmY-pGKq1y-NEE4pp-8iAAgP" 
}

POST /v1.0/getserialhistory

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

"history":
[
  {
    "_id":52,
    "action": 2,
    "actiondate":1530775886,
    "actionresult":0,
    "hdd":"12 FA DE 3E ..",
    "mb":"48 56 34 FF ..",
    "hardwareData": "Intel I7 6585 ..."
    "customer":
    {
        "_id":5,
        "description":"sw",
        "email":"de@a",
        "name":"Max",
        "phone":"9037771527",
        "status":1,
		"crmid": "",
		"refid": ""
  }
  },
...
]


Поиск ячеек памяти по имени или идентификатору

Авторизация требуется. Входные параметры RAW JSON:

{
"searchstring": "my" 
}

POST /v1.0/search/memoryitems

Для запроса доступна сортировка и пагинация. Доступные поля сортировки: aliasid, name (по умолчанию).

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

{
    "memoryitems": [
        {
            "_id": 3,
            "accesstype": 1,
            "action": 1,
            "aliasid": 37,
            "crmid": "",
            "description": "mylicense",
            "name": "mylicense",
            "params": [
                {
                    "_id": 2,
                    "data": "VVZXWFlgYWJj",
                    "description": "param_first",
                    "editallowed": true,
                    "name": "param_first",
                    "offset": 0,
                    "size": 9
                },
                {
                    "_id": 3,
                    "data": "VVZXWFlgYWJjZA==",
                    "description": "param1",
                    "editallowed": true,
                    "name": "param1",
                    "offset": 20,
                    "size": 10
                }
            ],
            "readpassword": 123,
            "refid": "",
            "size": 100,
            "totalparams_size": 30,
            "writepassword": 0
        }
    ]
}
  • No labels