This page refers to End-user REST API version 2 only. See End-user REST API for links to other versions of the End-user REST API.


The following page lists the HTTP operations that need to be performed to successfully query an LAC license using the End-user REST API version 2. 

To obtain a license for a given activation key filtered by its state, use the following request:

GET /licenses/(activation_key)?state=(states) 

where:

and

  • state (string) indicates a required, comma-separated value. The state can be one of the following: success, failed, in_progress.

    Note: The order of the states is irrelevant and does not influence the results of the request.

Also note that request headers are used by default.

Example request

GET/rest/v2/licenses/25N8D-NC35D-WD01P-8JI4K?state=success,failed HTTP/1.1 
Host: license.x-formation.com
Accept: application/hal+json

Response

The LAC REST API returns standard HTTP response codes described in the following table.

Status CodeHeader FieldDescription
200 OKCollection of licenses for a given state.
400 Bad RequestUnsupported license state.
403 ForbiddenLicense order has been disabled.
404 Not FoundNo licenses were found for a given state.

Example responses

HTTP/1.1 200 OK
Content-Type: application/hal+json

{
    "_links": {
        "success": [
            {
                "href": "https://license.x-formation.com/rest/v2/licenses/25N8D-NC35D-WD01P-8JI4K/Q1VTVE9NPWE="
            },
            {
                "href": "https://license.x-formation.com/rest/v2/licenses/25N8D-NC35D-WD01P-8JI4K/Q1VTVE9NPWI="
            }
        ],
        "failed": [
            {
                "href": "https://license.x-formation.com/rest/v2/license-errors/25N8D-NC35D-WD01P-8JI4K/Q1VTVE9NPXNkZnNkZnNkZg=="
            }
        ]
    },
    "_embedded": {
        "success": [
            {
                "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/v2/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/v2/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/v2/license-errors/25N8D-NC35D-WD01P-8JI4K/Q1VTVE9NPXNkZnNkZnNkZg=="
                    }
                }
            }
        ]
    }
}
HTTP/1.1 400 Bad Request
Content-Type: application/hal+json
 
{
	"code": 1101,
    "message": "Invalid data."
}
HTTP/1.1 403 Forbidden
Content-Type: application/hal+json
 
{
	"code": 1703,
    "message": "License order disabled."
}
HTTP/1.1 404 Not Found
Content-Type: application/hal+json

For more information about HTTP methods, see Supported HTTP methods. 

  • No labels