License

A verified OpenDrives License permits use of our RESTful API. Without a valid license, the only actions permitted on the API are Logging In, Logging Out, retrieving the System Fingerprint, and ingesting the License provided by OpenDrives

Basic Operations

Basic operations of Get License, Get Fingerprint, and Ingest License are available

Get License

Call to /license to get your license file

Request Object

+ URL
  /api/v2/license

+ Method
  GET

+ Headers
  Content-Type: application/json
  token: ThisIsNotARealTokenGenerateYourOwnToken

+ Body
  {}

Response Object

Sending this should get you back a valid response, an object with the issue, expiration, and raw output of the verified license.

+ Headers
  X-Powered-By: OpenDrives
  Access-Control-Allow-Origin: *
  Content-Type: application/json; charset=utf-8

+ Body
  {
    "start": "2020-09-22T21:46:07.000Z",
    "end": "2021-09-22T21:46:36.000Z",
    "raw": "-----BEGIN CERTIFICATE-----\nlicenseInformationHerelicenseInformationHerelicenseInformationHerelicenseInformationHere\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\nlicenseInformationHerelicenseInformationHerelicenseInformationHerelicenseInformationHere\n-----END CERTIFICATE-----\n-----BEGIN SIGNATURE-----\nlicenseInformationHerelicenseInformationHerelicenseInformationHerelicenseInformationHere==\n-----END SIGNATURE-----"
  }

Get Fingerprint

Call to /license/identity to get the unique system fingerprint

Request Object

+ URL
  /api/v2/license/identity

+ Method
  GET

+ Headers
  Content-Type: application/json
  token: ThisIsNotARealTokenGenerateYourOwnToken

+ Body
  {}

Response Object

Sending this should get you back a valid response, an object with the fingerprint you requested.

+ Headers
  X-Powered-By: OpenDrives
  Access-Control-Allow-Origin: *
  Content-Type: application/json; charset=utf-8

+ Body
  {
    "fingerprint": "fingerprintInfoHerefingerprintInfoHerefingerprintInfoHerefingerprintInfoHerefingerprintInfoHerefingerprintInfoHerefingerprintInfoHerefingerprintInfoHerefingerprintInfoHerefingerprintInfoHerefingerprintInfoHerefingerprintInfoHerefingerprintInfoHerefingerprintInfoHerefingerprintInfoHere="
  }

Ingest License

Call to /license/ingest to save your new or updated verified OpenDrives license.

Request Object

+ URL
  /api/v2/license/ingest

+ Method
  POST

+ Headers
  Content-Type: application/json
  token: ThisIsNotARealTokenGenerateYourOwnToken

+ Body
  {
    "licenseData": "-----BEGIN CERTIFICATE-----\nlicenseInformationHerelicenseInformationHerelicenseInformationHerelicenseInformationHere\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\nlicenseInformationHerelicenseInformationHerelicenseInformationHerelicenseInformationHere\n-----END CERTIFICATE-----\n-----BEGIN SIGNATURE-----\nlicenseInformationHerelicenseInformationHerelicenseInformationHerelicenseInformationHere==\n-----END SIGNATURE-----"
  }

Response Object

Sending this should get you back a valid response, an empty object.

+ Headers
  X-Powered-By: OpenDrives
  Access-Control-Allow-Origin: *
  Content-Type: application/json; charset=utf-8

+ Body
  {}