...
To obtain a license for a given activation key filetered Activation Key filtered by its state, use the following request. (Note that the order of states is optional.):
Panel |
---|
|
...
?state=( |
...
states) |
where the request parameters are as follows:
- The activation_key (string) , which is your product activation key, and
. - The state states (string), which are indicates a required, comma-separated , and available states, i.e.value, which can be one of the following: activated, failed, in-progress. Note that the order of the states is not significant.
(Note that : The request headers are used by default.)
Example request
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
GET /rest/v1/ liceneslicenses/4CT1V 25N8D-4T10N NC35D-K3Y1S-C000L/dHlwZTE9dmFsdwUxLHR5cGUyPXZhbHVlPTI= WD01P-8JI4K?state=activated,failed HTTP/1.1 Host: license.x-formation.com Accept: application/hal_ +json |
Response
The LAC REST API returns standard HTTP response codes as described in the following table.
Status Code | Header Field | Description |
---|---|---|
200 OK | The collection of licenses for a given state. | |
400 Bad Request | Unsupported license state. | |
403 Forbidden | The license order has been disabled. | |
404 Not Found | No licenses were found for a given state. |
Example response
Code Block | ||
---|---|---|
| ||
HTTP/1.1 200 OK Content-Type: application/hal+json [ { "request_time": "2012-05-03 02:10:48", "activation_time: "2012-05-03 02:12:48", "license": "3qfhb34q89g-7bqh-qhff3fg379n6349mzfeuoylgaw4807g*& GQWEdf806VGQ#F807gQF87g" }, { "request_time": "2012-05-03 02:10:48", "activation_time": null, "license": null } ]
{
"_links": {
"activated": [
{
"href": "https://license.x-formation.com/rest/v1/licenses/25N8D-NC35D-WD01P-8JI4K/Q1VTVE9NPWE="
},
{
"href": "https://license.x-formation.com/rest/v1/licenses/25N8D-NC35D-WD01P-8JI4K/Q1VTVE9NPWI="
}
],
"failed": [
{
"href": "https://license.x-formation.com/rest/v1/license-errors/25N8D-NC35D-WD01P-8JI4K/Q1VTVE9NPXNkZnNkZnNkZg=="
}
]
},
"_embedded": {
"activated": [
{
"activationKey": "25N8D-NC35D-WD01P-8JI4K",
"activationTime": "2014-04-29T11:31:51+00:00",
"expirationDate": null,
"maintenanceEndDate": null,
"hostids": [
{
"nameRaw": "CUSTOM",
"name": "Custom",
"value": "a"
}
],
"content": "# This license is generated using X-Formation License Activation Center
# Generation Time: 2014-04-29 11:31:50 GMT
# Activation Key: 25N8D-NC35D-WD01P-8JI4K
FEATURE feature-1
{
VENDOR=X-FORMATION VERSION=1.0
KEY=QQkUjKBGw6vPmoNM7cQIeHriCThHSD7psQSp0]YRAibvJbD]hrxC]fiZ1VyAnjb9uJuNivH67TIn7ygcOzO4AUNfVrgQ0oooFlhh \
tapNGT0hc1xe2UdTxxFt2y0S1Zi6uZ[JDpFc27Bjq3AIDSI7br[VrUqYGovQvkGnqwFk9ADKt9lEvTmirWz27FjEg2WIpGh[Qaatc \
te2tEXcIvy[iFH1e]jj18LQcHXnp8ze4zzeHyoGfXeqIL[BdELtQQ6q5oKJ8ACmrfZF2Rh2tKZOWKq4xXs4xmn0XsdRT3QDco2o9d \
ttwtPAh2ABimjNbrlPF8V9sabGw5]GU4poT7rq]pyDjnckbLTZ9z5f]4K[Tbb]Aa7406K8gx4dO6wFITq0NRgmmfFOLSEn6KHdwFf \
tERlqVXGzGjU7R490iA6cc43cnbHom[qMGboDOmIysXreBLgrWJ2wURL97U83njRQaL4qSHXXIVGTSxSvVCoWFcVq3urCHHAMhsaw
}",
"filename": "license_2014_04_29-11_31.lic",
"_links": {
"self": {
"href": "https://license.x-formation.com/rest/v1/licenses/25N8D-NC35D-WD01P-8JI4K/Q1VTVE9NPWE="
}
}
},
{
"activationKey": "25N8D-NC35D-WD01P-8JI4K",
"activationTime": "2014-05-06T13:42:16+00:00",
"expirationDate": null,
"maintenanceEndDate": null,
"hostids": [
{
"nameRaw": "CUSTOM",
"name": "Custom",
"value": "b"
}
],
"content": "# This license is generated using X-Formation License Activation Center
# Generation Time: 2014-04-29 11:31:50 GMT
# Activation Key: 25N8D-NC35D-WD01P-8JI4K
FEATURE feature-2
{
VENDOR=X-FORMATION VERSION=1.0
KEY=QQkUjKBGw6vPmoNM7cQIeHriCThHSD7psQSp0]YRAibvJbD]hrxC]fiZ1VyAnjb9uJuNivH67TIn7ygcOzO4AUNfVrgQ0oooFlhh \
tapNGT0hc1xe2UdTxxFt2y0S1Zi6uZ[JDpFc27Bjq3AIDSI7br[VrUqYGovQvkGnqwFk9ADKt9lEvTmirWz27FjEg2WIpGh[Qaatc \
te2tEXcIvy[iFH1e]jj18LQcHXnp8ze4zzeHyoGfXeqIL[BdELtQQ6q5oKJ8ACmrfZF2Rh2tKZOWKq4xXs4xmn0XsdRT3QDco2o9d \
ttwtPAh2ABimjNbrlPF8V9sabGw5]GU4poT7rq]pyDjnckbLTZ9z5f]4K[Tbb]Aa7406K8gx4pO6wFITq0NRgmmfFOLSEn6KHdwFf \
tERlqVXGzGjU7R490iA6cc43cnbHom[qMGboDOmIysXreBLgrWJ2wURL97U83njRQaL4qSHXXIVGTSxSvVCoWFcVq3urCHHAMhsaw
}",
"filename": "license_2014_06_05-13_42.lic",
"_links": {
"self": {
"href": "https://license.x-formation.com/rest/v1/licenses/25N8D-NC35D-WD01P-8JI4K/Q1VTVE9NPWI="
}
}
}
],
"failed": [
{
"errors": [
{
"message": "LM-X XML License Generator v4.5.3
Copyright (C) 2002-2013 X-Formation. All rights reserved.
LM-X Error: Unable to parse and load xml file /tmp/lgtmp_id_2/1400064446_139933.in!
LM-X Error: /tmp/lgtmp_id_2/1400064446_139933.in(7): not well-formed (invalid token)!",
"creationTime": "2014-05-08T07:17:41+00:00"
}
],
"_links": {
"self": {
"href": "https://license.x-formation.com/rest/v1/license-errors/25N8D-NC35D-WD01P-8JI4K/Q1VTVE9NPXNkZnNkZnNkZg=="
}
}
}
]
}
} |
For more information about HTTP methods, see Supported HTTP methods.