License API
License Feature Check
9 min
{ "tab" "examples", "url" " /api/v4/check license feature", "name" " /api/v4/check license feature", "method" "get", "request" { "pathparameters" \[], "queryparameters" \[ { "kind" "required", "name" "hardware id", "type" "string", "children" \[], "description" "unique hardware id generated for the client device" }, { "kind" "required", "name" "product", "type" "string", "children" \[], "description" "product short code" }, { "name" "feature", "kind" "required", "type" "string", "description" "feature code", "children" \[] }, { "kind" "optional", "name" "license key", "type" "string", "children" \[], "description" "required if product is key based (see section below)" }, { "kind" "optional", "name" "username", "type" "string", "children" \[], "description" "required if product is user based (see section below)" }, { "name" "license id", "kind" "optional", "type" "number", "description" "ensures that the action affects only the license with the specified id this is useful if e g you have multiple licenses for the same product assigned to the same user for obtaining a list of licenses assigned to a user, see \\"user licenses\\"", "children" \[] } ], "headerparameters" \[ { "kind" "required", "name" "date", "type" "string", "children" \[], "description" "in rfc7231 format (see \\"license api authorization\\"), eg thu, 17 nov 2022 20 51 35 gmt" }, { "kind" "required", "name" "authorization", "type" "string", "children" \[], "description" "see \\"license api authorization\\" article" } ], "bodydataparameters" \[], "formdataparameters" \[] }, "results" { "languages" \[ { "id" "qlx3ifr3fpkeqnnhkuaxk", "code" "{\n \\"id\\" 1698664358119314,\n \\"code\\" \\"f0\\",\n \\"name\\" \\"f0\\",\n \\"feature type\\" \\"activation\\",\n \\"expiry date\\" null,\n \\"metadata\\" {},\n \\"is floating\\" false,\n \\"is floating cloud\\" true,\n \\"floating timeout\\" 120,\n \\"floating users\\" 8,\n \\"floating in use devices\\" 1,\n \\"license id\\" 1698662161371339\n}", "language" "200", "customlabel" "" } ], "selectedlanguageid" "qlx3ifr3fpkeqnnhkuaxk" }, "examples" { "languages" \[ { "id" "lhd uaiv7ofbyvv2llluw", "language" "curl", "code" "curl location request get '/api/v4/check license feature?hardware id=string\&product=string\&feature=string' \\\\\n header 'accept application/json' \\\\\n header 'content type application/json'", "customlabel" "" }, { "id" "wzw1bjdviqlggtv4tmczd", "language" "nodejs", "code" "var request = require('request');\nvar options = {\n 'method' 'get',\n 'url' '/api/v4/check license feature?hardware id=string\&product=string\&feature=string',\n 'headers' {\n 'accept' 'application/json',\n 'content type' 'application/json'\n }\n};\nrequest(options, function (error, response) {\n if (error) throw new error(error);\n console log(response body);\n});\n", "customlabel" "" }, { "id" "ptibgbayc3qu8zefyftps", "language" "javascript", "code" "var myheaders = new headers();\nmyheaders append(\\"accept\\", \\"application/json\\");\nmyheaders append(\\"content type\\", \\"application/json\\");\n\nvar requestoptions = {\n method 'get',\n headers myheaders,\n redirect 'follow'\n};\n\nfetch(\\"/api/v4/check license feature?hardware id=string\&product=string\&feature=string\\", requestoptions)\n then(response => response text())\n then(result => console log(result))\n catch(error => console log('error', error));", "customlabel" "" }, { "id" "kobjoqpaifqa2b0gcaqrg", "language" "python", "code" "import requests\nimport json\n\nurl = \\"/api/v4/check license feature?hardware id=string\&product=string\&feature=string\\"\n\npayload={}\nheaders = {\n 'accept' 'application/json',\n 'content type' 'application/json'\n}\n\nresponse = requests request(\\"get\\", url, headers=headers, data=payload)\n\nprint(response text)\n", "customlabel" "" }, { "id" "teywqeggmgjqtmeopjpyl", "language" "ruby", "code" "require \\"uri\\"\nrequire \\"json\\"\nrequire \\"net/http\"\n\nurl = uri(\\"/api/v4/check license feature?hardware id=string\&product=string\&feature=string\\")\n\nhttp = net http new(url host, url port);\nrequest = net http get new(url)\nrequest\[\\"accept\\"] = \\"application/json\\"\nrequest\[\\"content type\\"] = \\"application/json\\"\n\nresponse = http request(request)\nputs response read body\n", "customlabel" "" } ], "selectedlanguageid" "lhd uaiv7ofbyvv2llluw" }, "description" "checks a license device against a license feature once checked, this device will be connected to the feature if a feature is a floating feature, device will also take one floating slot if available \n", "currentnewparameter" { "label" "query parameter", "value" "queryparameters" } } schema request query parameters type licensefeaturecheckrequestparams = ({ // for key based licenses license key string } | { // for user based licenses username string }) & { // required properties hardware id string product string feature string // optional properties license id? number | undefined } json schema { "$schema" "https //json schema org/draft/2020 12/schema", "type" "object", "allof" \[ { "oneof" \[ { "type" "object", "properties" { "license key" { "type" "string" } }, "required" \["license key"], "additionalproperties" false }, { "type" "object", "properties" { "username" { "type" "string" } }, "required" \["username"], "additionalproperties" false } ] }, { "type" "object", "properties" { "hardware id" { "type" "string" }, "product" { "type" "string" }, "feature" { "type" "string" }, "license id" { "type" \["number", "null"] } }, "required" \["hardware id", "product", "feature"], "additionalproperties" false } ] } response body type licensefeaturecheckresponsebody = { allow negative consumptions boolean, allow overages boolean, allow unlimited consumptions boolean, code string, consumption period string, expiry date null | string, feature type string, id number, is floating cloud boolean, is floating boolean, license id number, max consumption number, max overages number, metadata json, name string, reset consumption boolean, total consumptions number, // the following property is only present on floating and floating cloud features floating in use devices? number, } json schema { "$schema" "https //json schema org/draft/2020 12/schema", "type" "object", "properties" { "allow negative consumptions" { "type" "boolean" }, "allow overages" { "type" "boolean" }, "allow unlimited consumptions" { "type" "boolean" }, "code" { "type" "string" }, "consumption period" { "type" "string" }, "expiry date" { "type" \["string", "null"] }, "feature type" { "type" "string" }, "id" { "type" "number" }, "is floating cloud" { "type" "boolean" }, "is floating" { "type" "boolean" }, "license id" { "type" "number" }, "max consumption" { "type" "number" }, "max overages" { "type" "number" }, "metadata" { "type" "object" }, "name" { "type" "string" }, "reset consumption" { "type" "boolean" }, "total consumptions" { "type" "number" }, "floating in use devices" { "type" "number" } }, "required" \[ "allow negative consumptions", "allow overages", "allow unlimited consumptions", "code", "consumption period", "expiry date", "feature type", "id", "is floating cloud", "is floating", "license id", "max consumption", "max overages", "metadata", "name", "reset consumption", "total consumptions" ], "additionalproperties" false } response contains a license feature fields floating in use devices number of devices currenly in use on this license feature license id id of the license errors if an error occurs, the response will have an http status code of 400 or higher, and the response body will contain an error description in the following format { status number, code string, message string } json schema { "$schema" "https //json schema org/draft/2020 12/schema", "type" "object", "properties" { "status" { "type" "number" }, "code" { "type" "string" }, "message" { "type" "string" } }, "required" \[ "status", "code", "message" ], "additionalproperties" false } list of exceptions missing headers (400) some headers are missing unknown product (400) provided product was not found license not found (400) license with the provided license user not found license not enabled (400) the license is not enabled license not active (400) the license is not active device not found (400) an active device matching the hardware id not found blacklisted (400) this device is blacklisted invalid license feature code (400) license feature code ' + param + ' is invalid or not assigned to the license floating not available (400) no available slots for floating license