Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The least secure API uses a "camera access token" for authorization and it's designed for use with front-ends like web and mobile apps. The “camera access token” is a unique camera identifier that can change anytimebe changed at any time.

All function calls require an authorization header:

...

Code Block
curl -X GET \
  "https://web.skyvr.videoexpertsgroupvxgdemo.vxgdemo.cloud-vms.com/api/v4/live/watch/" \
  -H "accept: application/json" \
  -H "Authorization: Acc eyJjYW1pZCI6IDI0ODUyNywgImNtbmdyaWQiOiAyNDg5NjQsICJhY2Nlc3MiOiAiYWxsIiwgInRva2VuIjogInNoYXJlLmV5SnphU0k2SURJek5UWXpPWDAuNjFhOTY0YzN0YmMxZmFiMDAueEJXWGRrc0FVUnY2d3M1TU9aWC1BUUloLUtNIiwgImFwaSI6ICJ3ZWIuc2t5dnIudmlkZW9leHBlcnRzZ3JvdXAuY29tIiwgImNhbSI6ICJjYW0uc2t5dnIudmlkZW9leHBlcnRzZ3JvdXAuY29tIn0="

...

The next level is Admin API and which uses a "license key" for authorization and it's designed for use to be used from a back-end. On this level, the API can add new cameras and control cloud resources. It can also retrieve “camera access tokens” and generate new ones. There is one "license key" per account/user (which can be a user or , organization, or customer).

The “license key” should be injected into the Authorization header of every request:

...

Code Block
curl -X GET \
  "https://web.vxgdemo.skyvrvxgdemo.videoexpertsgroupcloud-vms.com/api/v3/channels/" \
  -H "accept: application/json" \
  -H "Authorization: LKey v3.X9tKpuXq0btatj"

...

Code Block
curl -X POST \
  --key ./company.key\
  --cert ./company.crt\
  -k\
  https://ip:9000/api/v2/admin/users/\
  -H "accept: application/json" \
  -H "Content-Type: application/json" \
  -d "{ \"suid\": \"user_id\", \"usrc\": \"Company_name\", \"license_key\": {\"value\": \"LICENSEKEY\"}, \" limits\": {\"hosted_cameras\": 100} }"

V2 API

...

Authorization - license key (LKey)

https://web.vxgdemo.skyvrvxgdemo.videoexpertsgroupcloud-vms.com/docs/v2.html

V3 API

...

Authorization - license key (LKey)

https://web.skyvr.videoexpertsgroupvxgdemo.vxgdemo.cloud-vms.com/docs/v3.html

V4 API

...

Authorization - access token (Acc)

https://web.skyvr.videoexpertsgroupvxgdemo.vxgdemo.cloud-vms.com/docs/v4.html

V5 API

...

Authorization - group access token (SI)

https://web.skyvr.videoexpertsgroupvxgdemo.vxgdemo.cloud-vms.com/docs/v5.html

V2 Super-admin API

...

Authorization - SSL key/certificate pair.

https://web.skyvr.videoexpertsgroupvxgdemo.vxgdemo.cloud-vms.com/docs/v2_admin.html

...