API FUNDAMENTALS

GENERAL

The SLASCONE API follows the OpenAPI (3.0) specification, is HTTPS only, built using REST principles, following all state of the art best practices for API security.

All SLASCONE functions are invokable through the API, allowing a seamless integration with other back-office systems such as CRM/ERP etc.

You can easily test the API using our official API Test Center.

AUTHENTICATION

In order to authenticate (regardless if you are testing the API using our test center or from your source code), you need to use an apiKey.

There are two apiKeys available (both can be found in the Info area of SLASCONE):

• The Provisioning apiKey (ProvisioningKey). This apiKey enables you to call all methods needed for licensing and analytics scenarios. In other words, this is the key to be embedded in your software. This key authorizes the following API controllers:
  • data_exchange

  • data_gathering

  • lookup

  • provisioning

• The Administration apiKey (AdminKey). This apiKey enables you to call ALL SLASCONE methods. This is meant for testing or administration purposes only. It is not recommended embedding this key in your software.

POSTMAN

If you are using Postman, you need to import an API using the following link

https://api.slascone.com/swagger/v2/swagger.json

and use API Key based authorization added to the header, as shown here:

GENERATING CLIENTS

You can easily generate clients in your programming language using the online swagger editor. Select file, import URL and type in:

https://api.slascone.com/swagger/v2/swagger.json

Next select Generate client and choose the language of your choice. The end result is a zip file you can download with the generated client code.

COMMON PARAMETERS

Most API methods require all or some of the following parameters:

• isv_id: This can be found in the Info area of SLASCONE.
• product_id: This can be found in the Products area of SLASCONE. Select your product and click on the Copy Key icon.
• client_id: Each to be licensed client, needs to generate a unique device id.
• license_key: This is the license key generated from SLASCONE. It consists of n tokens. A license key can be used/activated n times.
• token_key: A license consists of n tokens. A token key can be used/activated only once (one client).

Your provisioning workflow (which means the API functions that need to be called) depends on your product's licensing mode.