{"note":"OpenAPI conversion -- returning structured metadata","name":"netlicensing-io","description":"Labs64 NetLicensing RESTful API Test Center","version":"2.x","base_url":"https://go.netlicensing.io/core/v2/rest","endpoints":40,"raw":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Labs64 NetLicensing RESTful API Test Center\n@base https://go.netlicensing.io/core/v2/rest\n@version 2.x\n@auth basic\n@endpoints 40\n@hint download_for_search\n@toc product(5), productmodule(5), licensetemplate(5), licensee(7), license(5), transaction(4), token(4), paymentmethod(3), utility(2)\n\n@group product\n@endpoint GET /product\n@desc List Products\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /product\n@desc Create Product\n@required {active: any # If set to 'false', the Product is disabled. No new Licensees can be registered for the Product, existing Licensees can not obtain new Licenses., name: any # Product name. Together with the version identifies the Product for the end customer., version: any # Product version. Convenience parameter, additional to the Product name.}\n@optional {number: any # Unique number that identifies the Product. Vendor can assign this number when creating a Product or let NetLicensing generate one., licenseeAutoCreate: any # If set to 'true', non-existing Licensees will be created at first validation attempt., description: any # Product description., licensingInfo: any # Licensing information., vatMode: any # Vat mode for Product. Supported types: GROSS, NET}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 402: Quota exceeded, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint GET /product/{productNumber}\n@desc Get Product\n@required {productNumber: any # Unique number that identifies the Product.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /product/{productNumber}\n@desc Update Product\n@required {productNumber: any # Unique number that identifies the Product.}\n@optional {number: any # New Product number (update), active: any # If set to 'false', the Product is disabled. No new Licensees can be registered for the Product, existing Licensees can not obtain new Licenses., name: any # Product name. Together with the version identifies the Product for the end customer., version: any # Product version. Convenience parameter, additional to the Product name., licenseeAutoCreate: any # If set to 'true', non-existing Licensees will be created at first validation attempt., description: any # Product description., licensingInfo: any # Licensing information., vatMode: any # Vat mode for Product. Supported types: GROSS, NET}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 402: Quota exceeded, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint DELETE /product/{productNumber}\n@desc Delete Product\n@required {productNumber: any # Unique number that identifies the Product.}\n@optional {forceCascade: any # Force object deletion and all descendants.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endgroup\n\n@group productmodule\n@endpoint GET /productmodule\n@desc List Product Modules\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /productmodule\n@desc Create Product Module\n@required {productNumber: any # Unique number (across all Products of a Vendor) that identifies the Product Module. Vendor can assign this number when creating a Product Module or let NetLicensing generate one. Read-only after creation of the first Licensee for the Product., active: any # If set to 'false', the Product Module is disabled. Licensees can not obtain any new Licenses for this Product Module., name: any # Product Module name that is visible to the end customers in NetLicensing Shop., licensingModel: any # Licensing model applied to this Product Module. Defines what License Templates can be configured for the Product Module and how Licenses for this Product Module are processed during validation.}\n@optional {number: any # Unique number (across all Products of a Vendor) that identifies the Product Module. Vendor can assign this number when creating a Product Module or let NetLicensing generate one. Read-only after creation of the first Licensee for the Product., maxCheckoutValidity: any # Maximum checkout validity (days). Mandatory for 'Floating' licensing model., yellowThreshold: any # Remaining time volume for yellow level. Mandatory for 'Rental' licensing model., redThreshold: any # Remaining time volume for red level. Mandatory for 'Rental' licensing model., nodeSecretMode: any # Secret Mode. Mandatory for 'Node-Locked' licensing model., licenseTemplate: any # License Template. Mandatory for 'Try & Buy' licensing model.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 402: Quota exceeded, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint GET /productmodule/{productModuleNumber}\n@desc Get Product Module\n@required {productModuleNumber: any # Unique number (across all Products of a Vendor) that identifies the Product Module. Vendor can assign this number when creating a Product Module or let NetLicensing generate one. Read-only after creation of the first Licensee for the Product.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /productmodule/{productModuleNumber}\n@desc Update Product Module\n@required {productModuleNumber: any # Unique number (across all Products of a Vendor) that identifies the Product Module. Vendor can assign this number when creating a Product Module or let NetLicensing generate one. Read-only after creation of the first Licensee for the Product.}\n@optional {number: any # New Product Module number (update)., active: any # If set to 'false', the Product Module is disabled. Licensees can not obtain any new Licenses for this Product Module., name: any # Product Module name that is visible to the end customers in NetLicensing Shop., licensingModel: any # Licensing model applied to this Product Module. Defines what License Templates can be configured for the Product Module and how Licenses for this Product Module are processed during validation., maxCheckoutValidity: any # Maximum checkout validity (days). Mandatory for 'Floating' licensing model., yellowThreshold: any # Remaining time volume for yellow level. Mandatory for 'Rental' licensing model., redThreshold: any # Remaining time volume for red level. Mandatory for 'Rental' licensing model., licenseTemplate: any # License Template. Mandatory for 'Try & Buy' licensing model., nodeSecretMode: any # Secret Mode. Mandatory for 'Node-Locked' licensing model.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 402: Quota exceeded, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint DELETE /productmodule/{productModuleNumber}\n@desc Delete Product Module\n@required {productModuleNumber: any # Unique number (across all Products of a Vendor) that identifies the Product Module.}\n@optional {forceCascade: any # Force object deletion and all descendants.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endgroup\n\n@group licensetemplate\n@endpoint GET /licensetemplate\n@desc List License Templates\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /licensetemplate\n@desc Create License Template\n@required {productModuleNumber: any # Number of Product Module to create License Template object, name: any # License Template name to create License Template object, active: any # If set to 'false', the License Template is disabled. Licensee can not obtain any new Licenses off this License Template., licenseType: any # Type of Licenses created from this License Template. Supported types: FEATURE, TIMEVOLUME, FLOATING, QUANTITY}\n@optional {number: any # Unique number (across all Products of a Vendor) that identifies the License Template. Vendor can assign this number when creating a License Template or let NetLicensing generate one. Read-only after creation of the first License from this License Template., timeVolume: any # Mandatory for 'TIMEVOLUME' License Type., timeVolumePeriod: any # For 'TIMEVOLUME' License Type., maxSessions: any # Mandatory for 'FLOATING' License Type., price: any # Price for the License. If >0, it must always be accompanied by the currency specification., currency: any # Specifies currency for the License price. Check data types to discover which currencies are supported., automatic: any # If set to 'true', every new Licensee automatically gets one License out of this License Template on creation. Automatic Licenses must have their price set to 0., hidden: any # If set to 'true', this License Template is not shown in NetLicensing Shop as offered for purchase., hideLicenses: any # If set to 'true', Licenses from this License Template are not visible to the end customer, but participate in validation., quantity: any # Mandatory for 'Pay-per-Use' and 'Node-Locked' License Model., quota: any # Mandatory for 'Quota' License Model.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint GET /licensetemplate/{licenseTemplateNumber}\n@desc Get License Template\n@required {licenseTemplateNumber: any # Unique number (across all Products of a Vendor) that identifies the License Template. Vendor can assign this number when creating a License Template or let NetLicensing generate one. Read-only after creation of the first License from this License Template.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /licensetemplate/{licenseTemplateNumber}\n@desc Update License Template\n@required {licenseTemplateNumber: any # Unique number (across all Products of a Vendor) that identifies the License Template. Vendor can assign this number when creating a License Template or let NetLicensing generate one. Read-only after creation of the first License from this License Template.}\n@optional {number: any # New License Template number (update)., name: any # Name for the Licensed item, active: any # If set to 'false', the License Template is disabled. Licensee can not obtain any new Licenses off this License Template., licenseType: any # Type of Licenses created from this License Template. Supported types: FEATURE, TIMEVOLUME, FLOATING, QUANTITY, timeVolume: any # Mandatory for 'TIMEVOLUME' License Type., timeVolumePeriod: any # For 'TIMEVOLUME' License Type., maxSessions: any # Mandatory for 'FLOATING' License Type., price: any # Price for the License. If >0, it must always be accompanied by the currency specification., currency: any # Specifies currency for the License price. Check data types to discover which currencies are supported., automatic: any # If set to 'true', every new Licensee automatically gets one License out of this License Template on creation. Automatic Licenses must have their price set to 0., hidden: any # If set to 'true', this License Template is not shown in NetLicensing Shop as offered for purchase., hideLicenses: any # If set to 'true', Licenses from this License Template are not visible to the end customer, but participate in validation., quantity: any # Mandatory for 'Pay-per-Use' and 'Node-Locked' License Model., quota: any # Mandatory for 'Quota' License Model.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint DELETE /licensetemplate/{licenseTemplateNumber}\n@desc Delete License Template\n@required {licenseTemplateNumber: any # Unique number (across all Products of a Vendor) that identifies the License Template.}\n@optional {forceCascade: any # Force object deletion and all descendants.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endgroup\n\n@group licensee\n@endpoint GET /licensee\n@desc List Licensees\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /licensee\n@desc Create Licensee\n@required {productNumber: any # 'productNumber' to assign new Licensee object, active: any # If set to 'false', the Licensee is disabled. Licensee can not obtain new Licenses, and validation is disabled}\n@optional {number: any # Unique number (across all Products of a Vendor) that identifies the Licensee. Vendor can assign this number when creating a Licensee or let NetLicensing generate one. Read-only after creation of the first License for the Licensee, name: any, markedForTransfer: any # Mark Licensee for transfer.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 402: Quota exceeded, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint GET /licensee/{licenseeNumber}\n@desc Get Licensee\n@required {licenseeNumber: any # Unique number (across all Products of a Vendor) that identifies the Licensee. Vendor can assign this number when creating a Licensee or let NetLicensing generate one. Read-only after creation of the first License for the Licensee.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /licensee/{licenseeNumber}\n@desc Update Licensee\n@required {licenseeNumber: any # Unique number (across all Products of a Vendor) that identifies the Licensee. Vendor can assign this number when creating a Licensee or let NetLicensing generate one. Read-only after creation of the first License for the Licensee.}\n@optional {number: any # New Licensee number (update)., active: any # If set to 'false', the Licensee is disabled. Licensee can not obtain new Licenses, and validation is disabled, name: any, markedForTransfer: any # Mark Licensee for transfer.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 402: Quota exceeded, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint DELETE /licensee/{licenseeNumber}\n@desc Delete Licensee\n@required {licenseeNumber: any # Unique number (across all Products of a Vendor) that identifies the Licensee.}\n@optional {forceCascade: any # Force object deletion and all descendants.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /licensee/{licenseeNumber}/validate\n@desc Validate Licensee\n@required {licenseeNumber: any # Licensee number with a maximum length of 1000 characters}\n@optional {licenseeName: any # Human-readable name for the auto-created Licensee (will be set as custom Licensee property), productNumber: any # Product number, must be provided when 'Licensee auto-create' is enabled (see also Product JavaDoc). Identifies the Product to which new Licensee should be added, productModuleNumber: any # 'Node-Locked' licensing model: product module number, nodeSecret: any # 'Node-Locked' licensing model: specifies unique secret, sessionId: any # 'Floating' licensing model: specifies unique session identifier, action: any # 'Floating' licensing model: check-out or check-in session action, to allocate or return it from/to the pool of available sessions}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /licensee/{licenseeNumber}/transfer\n@desc Transfer Licenses\n@required {licenseeNumber: any # Licensee number with a maximum length of 1000 characters, sourceLicenseeNumber: any # Licensee number which Licenses to be transferred}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endgroup\n\n@group license\n@endpoint GET /license\n@desc List Licenses\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /license\n@desc Create License\n@required {licenseeNumber: any, licenseTemplateNumber: any, active: any}\n@optional {number: any, name: any # Name for the Licensed item. Set from License Template on creation, if not specified explicitly., parentfeature: any # Mandatory for 'TIMEVOLUME' License Type and 'RENTAL' licensing model, timeVolume: any # Mandatory for 'TIMEVOLUME' License Type., timeVolumePeriod: any # For 'TIMEVOLUME' License Type., startDate: any # Mandatory for 'TIMEVOLUME' License Type., price: any # Price for the License. If >0, it must always be accompanied by the currency specification. Read-only, set from License Template on creation, currency: any # Specifies currency for the License price. Check data types to discover which currencies are supported. Read-only, set from License Template on creation, hidden: any # 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, quantity: any # Mandatory for 'Pay-per-Use' License Model., usedQuantity: any # Mandatory for 'Pay-per-Use' License Model.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint GET /license/{licenseNumber}\n@desc Get License\n@required {licenseNumber: any # 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.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /license/{licenseNumber}\n@desc Update License\n@required {licenseNumber: any # 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.}\n@optional {number: any # 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: any, name: any # Name for the Licensed item. Set from License Template on creation, if not specified explicitly., startDate: any # For 'TIMEVOLUME' License type, parentfeature: any, timeVolume: any # Mandatory for 'TIMEVOLUME' License Type., timeVolumePeriod: any # For 'TIMEVOLUME' License Type., price: any # Price for the License. If > 0, it must always be accompanied by the currency specification. Read-only, set from License Template on creation, currency: any # Specifies currency for the License price. Check data types to discover which currencies are supported. Read-only, set from License Template on creation, hidden: any # 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, quantity: any # Mandatory for 'Pay-per-Use' License Model., usedQuantity: any # Mandatory for 'Pay-per-Use' License Model.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint DELETE /license/{licenseNumber}\n@desc Delete License\n@required {licenseNumber: any # 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.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endgroup\n\n@group transaction\n@endpoint GET /transaction\n@desc List Transactions\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /transaction\n@desc Create Transaction\n@required {active: any # Always 'true' for Transactions, status: any, source: any # AUTO Transaction for internal use only}\n@optional {licenseeNumber: any, number: any # Unique number (across all Products of a Vendor) that identifies the Transaction, dateCreated: any, dateClosed: any, paymentMethod: any}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint GET /transaction/{transactionNumber}\n@desc Get Transaction\n@required {transactionNumber: any # Unique number (across all Products of a Vendor) that identifies the Transaction}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /transaction/{transactionNumber}\n@desc Update Transaction\n@required {transactionNumber: any # Unique number (across all Products of a Vendor) that identifies the Transaction}\n@optional {number: any # Unique number (across all Products of a Vendor) that identifies the Transaction, active: any # Always 'true' for Transactions, status: any, source: any # AUTO Transaction for internal use only, dateCreated: any, dateClosed: any, paymentMethod: any}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endgroup\n\n@group token\n@endpoint GET /token\n@desc List Tokens\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /token\n@desc Create token\n@required {tokenType: any # Token type to be generated}\n@optional {apiKeyRole: any # For tokenType=APIKEY only (default: ROLE_APIKEY_LICENSEE); defines token RoleID, type: any # For tokenType=DEFAULT only; action type to be set, action: any # For type=ACTION only; defines token action to be perfromed, licenseeNumber: any # For tokenType=SHOP or type=ACTION only (mandatory); identifies Licensee that will be assigned to the shop token, privateKey: any # For tokenType=APIKEY only (optional); defines PrivateKey to be used with the validate methodPlease Note: PrivateKey need to be provided as one line without spaces, productNumber: any # For tokenType=SHOP only (mandatory); identifies Product that will be assigned to the shop token, licenseTemplateNumber: any # For tokenType=SHOP only; identifies LicenseTemplate that will be assigned to the shop token, predefinedShoppingItem: any # For tokenType=SHOP only; identifies Shopping Item name that will be shown to the customer, successURL: any # For tokenType=SHOP only; take customers to this URL when they finish checkout, successURLTitle: any # For tokenType=SHOP only; shop link title for successful checkout process, cancelURL: any # For tokenType=SHOP only; take customers to this URL when they cancel their checkout, cancelURLTitle: any # For tokenType=SHOP only; shop link title for cancel checkout process}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint GET /token/{tokenNumber}\n@desc Get token\n@required {tokenNumber: any # Token number}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint DELETE /token/{tokenNumber}\n@desc Delete token\n@required {tokenNumber: any # Token number}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endgroup\n\n@group paymentmethod\n@endpoint GET /paymentmethod\n@desc List Payment Methods\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint GET /paymentmethod/{paymentMethodNumber}\n@desc Get Payment Method\n@required {paymentMethodNumber: any # Payment method number}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint POST /paymentmethod/{paymentMethodNumber}\n@desc Update Payment Method\n@required {paymentMethodNumber: any # Payment method number}\n@optional {active: any # If set to 'false', the Payment Method is disabled., paypal.subject: any # The e-mail address of the PayPal account for which you are making the API calls.}\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endgroup\n\n@group utility\n@endpoint GET /utility/licensingModels\n@desc List Licensing Models\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endpoint GET /utility/licenseTypes\n@desc List License Types\n@returns(200) Successful request\n@errors {400: Malformed or illegal request, 403: Access is denied, 404: Resource not found, 500: Internal service error}\n\n@endgroup\n\n@end\n"}