Skip to end of metadata
Go to start of metadata

Licenses list

Return a list of all licenses for the current vendor.

HTTP Method / URL

GET /core/v2/rest/license

Security

Basic Authentication

Request Header

Accept: application/json | application/xml

Request Parameters

- None -

HTTP Status Code

200 - Successful request
400 - Malformed or illegal request
403 - Access is denied
404 - Resource not found
500 - Internal service error

See also JavaDoc: LicenseService.list

 Example
Request
Response

Get license

Return a license by licenseNumber.

HTTP Method / URL

GET /core/v2/rest/license/{licenseNumber}

Security

Basic Authentication

Request Header

Accept: application/json | application/xml

Request Parameters

licenseNumber (string) - License number.

HTTP Status Code

200 - Successful request
400 - Malformed or illegal request
403 - Access is denied
404 - Resource not found
500 - Internal service error

See also JavaDoc: LicenseService.get

 Example
Request
Response

Create license

Creates a new license.

HTTP Method / URL

POST /core/v2/rest/license

Security

Basic Authentication

Request Header

Accept: application/json | application/xml
Content-Type: application/x-www-form-urlencoded

Request Parameters

licenseeNumber (string) - licenseeNumber to assign new license object.

licenseTemplateNumber (string) - licenseTemplateNumber to assign new license object. 

number (string) - Unique number (across all products/licensees of a vendor) that identifies the license. Vendor can assign this number when creating a license or let NetLicensing generate one. Read-only after corresponding creation transaction status is set to closed.

active (boolean) - If set to false, the license is disabled. License can be re-enabled, but as long as it is disabled, the license is excluded from the validation process.

name (string) - Name for the licensed item. Set from license template on creation, if not specified explicitly. Optional.

price (double) - price for the license. If >0, it must always be accompanied by the currency specification. Read-only, set from license template on creation. Optional.

currency (enum) - specifies currency for the license price. Check data types to discover which currencies are supported. Read-only, set from license template on creation. Optional.

- EUR       - Euro currency for the license price

hidden (boolean) - If set to 'true', this license is not shown in NetLicensing Shop as purchased license. Set from license template on creation, if not specified explicitly. Optional.

parentfeature (string) - Mandatory for 'TIMEVOLUME' license type and 'RENTAL' licensing model. Optional.

timeVolume (string) - Mandatory for 'TIMEVOLUME' license type. Optional.

HTTP Status Code

200 - Successful request
400 - Malformed or illegal request
403 - Access is denied
404 - Resource not found
500 - Internal service error

See also JavaDoc: LicenseService.create

 Example
Request
Response

Update license

Sets the provided properties to a license. Return an updated license.

HTTP Method / URL

POST /core/v2/rest/license/{licenseNumber}

Security

Basic Authentication

Request Header

Accept: application/json | application/xml
Content-Type: application/x-www-form-urlencoded

Request Parameters

licenseNumber (string) - Unique number (across all products/licensees of a vendor) that identifies the license. Vendor can assign this number when creating a license or let NetLicensing generate one. Read-only after corresponding creation transaction status is set to closed.

number (string) - Unique number (across all products/licensees of a vendor) that identifies the license. Vendor can assign this number when creating a license or let NetLicensing generate one. Read-only after corresponding creation transaction status is set to closed. Optional.

active (boolean) - If set to false, the license is disabled. License can be re-enabled, but as long as it is disabled, the license is excluded from the validation process. Optional.

name (string) - Name for the licensed item. Set from license template on creation, if not specified explicitly. Optional.

startDate (date-time) - for TIMEVOLUME licenseType

parentfeature (string) - Mandatory for 'TIMEVOLUME' license type and 'RENTAL' licensing model. Optional.

timeVolume (string) - Mandatory for 'TIMEVOLUME' license type. Optional.

price (double) - price for the license. If >0, it must always be accompanied by the currency specification. Read-only, set from license template on creation. Optional.

currency (enum) - specifies currency for the license price. Check data types to discover which currencies are supported. Read-only, set from license template on creation. Optional.

- EUR       - Euro currency for the license price

hidden (boolean) - If set to 'true', this license is not shown in NetLicensing Shop as purchased license. Set from license template on creation, if not specified explicitly. Optional.

HTTP Status Code

200 - Successful request
400 - Malformed or illegal request
403 - Access is denied
404 - Resource not found
500 - Internal service error

See also JavaDoc: LicenseService.update

 Example
Request
Response

Delete license

Delete a license by number.

HTTP Method / URL

DELETE /core/v2/rest/license/{licenseNumber}

Security

Basic Authentication

Request Header

Accept: application/json | application/xml

Request Parameters

licenseNumber (string) - License number.

HTTP Status Code

204 - Successful request
400 - Malformed or illegal request
403 - Access is denied
404 - Resource not found
500 - Internal service error

See also JavaDoc: LicenseService.delete

 Example
Request
Response