Versions Compared

Key

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

All communication Communication with the GraphQL Cloud API server has to be authorized via an access TOKEN. The valid TOKEN has to be inserted into the header of each API call. A TOKEN can be created by a user with full account access in the cloud IP cam platform. Using user TOKEN covers most of your integration use cases.


User TOKEN is one of two authorization options. The second option is use OAuth 2.0 It is recommended in most of integration use cases.

OAuth 2.0 is a second option how to create access token. It is much more complex.

Authorization header

Code Block
Authorization : Bearer $TOKEN

Where $TOKENis created token in the preview step.

You can test CURL in your terminal window. Replace the word TOKEN in the following example with the generated token.

Code Block
curl -X POST -H 'Authorization: Bearer $TOKEN' -H "Content-Type: application/json" --data-binary '{"query":"{cameraList{name}}"}' https://system2.netrex.cz/api/graphql.php

Response:

Code Block
languagejs
{"data":{"cameraList":[{"name":"myCamera"}]}

 

For testing purposes you can use our embedded API explorer, Postman or your own GraphQL client application.

TOKEN handling:

Panel
panelIconId2757
panelIcon:exclamation:
panelIconText
bgColor#FFBDAD

Be careful on TOKEN. Be sure what you do. You can update/delete important data on your account.
Make sure that your application stores TOKEN in secure way. Do not share tokens. Setup your security policy.