VidiNet API
This article is divided into the following sections:
Manage your VidiNet services programmatically using our API. See the API documentation for available features.
This following guide explains how to use your VidiNet account to authenticate, create, and apply changes to your services through the API using Postman.
Authentication
Generating an access token
Use your VidiNet account credentials to generate an access token.
![](../../__attachments/2551545907/auth.png?inst-v=c263b046-0db3-4e5e-9b28-d475c958150e)
Example: how to generate an access token and refresh token using Postman
Using the access token
Select the Bearer token authorization type in Postman and enter access_token from the response to authenticate towards all endpoints in the API.
![](../../__attachments/2551545907/image-20211012-083540.png?inst-v=c263b046-0db3-4e5e-9b28-d475c958150e)
Successful authentication towards the Vidinet API using bearer token authentication in Postman
Don’t forget to set your Request Header to “Content-Type = application/json”
Service creation
This is an example of the creation of a VidiCore Starter Edition in Ireland with restricted IP access.
![](../../__attachments/2551545907/service_launch.png?inst-v=c263b046-0db3-4e5e-9b28-d475c958150e)
Use the unique identifier from the response to check the service state
![](../../__attachments/2551545907/service_get.png?inst-v=c263b046-0db3-4e5e-9b28-d475c958150e)
Update service
Use service endpoint with PATCH method to apply changes to your service.
This example will allow public access to the previously created VidiCore service
![](../../__attachments/2551545907/acl_allow_all.png?inst-v=c263b046-0db3-4e5e-9b28-d475c958150e)
Set desired state of your service
![](../../__attachments/2551545907/paused.png?inst-v=c263b046-0db3-4e5e-9b28-d475c958150e)