Skip to main content

License API

Updated

Installing the app

Before activating the license, you have to install the appropriate ACAP application on your camera. You can download the required installation package from here. The installation can be done manually in the App section in the Axis camera user interface, via VAPIX API, or through Axis Device Manager.

 

Generating a signature for the camera on our server

Assign an unused license code to the camera. A trial license or full license can be obtained via our web pages.

The license can be activated via a GET request below

https://camstreamer.com/license-api/activate?serial_number=SERIAL_NUMBER&app_name=APP_NAME&license_code=LICENSE_CODE&email=EMAIL

where

SERIAL_NUMBER is a serial number of your Axis camera
APP_NAME is a name of the application you want to activate, our application names in API are: camstreamer, camoverlay, camscripter, camswitcher
EMAIL an email that will be used for registration of your license on our server
LICENSE_CODE license code you want to activate on your camera

Response:

{
  "code": "OK",
  "message": "",
  "data": {
    "app_parameters": {
      "Expire": 0,
      "Signature": "03b5ba689da104f5812277a6e217aa02765ed3953b7bd4967dca4251ed82b245",
      "LicenseCode": "CS-1TV0TTL41OY7CZJBW123"
    }
  }
}

 

Errors

{
  "code": "ERR_INVALID_ARGUMENT",
  "message": "Unsupported email format."
}

 

{
  "code": "ERR_FAILED_TO_ACTIVATE",
  "message": "This camera already has an unlimited license."
}

 

Saving the signature to the camera

After successfully obtaining the response, you have to load app_parameters to the camera. Note that before the name of the parameter you have to put "APP_NAME." See the example below:

http://USER:PASS@IPADDR[:PORT]/axis-cgi/param.cgi?action=update&APP_NAME.Expire=EXPIRE_NUMBER&APP_NAME.Signature=SIGNATURE_STRING&APP_NAME.LicenseCode=LICENSE_CODE

where

USER is an user name. E.g. root
PASS is a password . E.g. pass
IPADDR[:PORT] is an IP address:port of the camera. E.g. 192.168.91.202
APP_NAME is a name of the application you want to activate, our application names in API are: camstreamer, camoverlay, camscripter, camswitcher
EXPIRE_NUMBER value of the expiration from the response from section Generating a signature for the camera on our server
SIGNATURE_STRING string with the signature from the first response from section Generating a signature for the camera on our server
LICENSE_CODE your license code used in the first request and from from the first response

Example

http://root:pass@192.168.91.202/axis-cgi/param.cgi?action=update&Camstreamer.Expire=0&Camstreamer.Signature=03b5ba689da104f5812277a6e217aa02765ed3953b7bd4967dca4251ed82b245&Camstreamer.LicenseCode=CS-1TV0TTL41OY7CZJBW123

 

Powered by Zendesk