Please Select Your Location
Australia
Österreich
België
Canada
Canada - Français
中国
Česká republika
Denmark
Deutschland
France
HongKong
Iceland
Italia
日本
Korea
Latvija
Lietuva
Lëtzebuerg
Malta
المملكة العربية السعودية (Arabic)
Nederland
New Zealand
Norge
Polska
Portugal
Russia
Saudi Arabia
Southeast Asia
España
Suisse
Suomi
Sverige
台灣
Ukraine
United Kingdom
United States

Service token management

Position Parameter Name Type Description
{1} query appId string VIVEPORT ID of the title requiring access to VIVEPORT internal services
{2} query appSecret string App secret provided by VIVEPORT support

HTTP Method: GET

URL: https://www.viveport.com/api/thirdpartygatewayservice/v1/monitor/servicetoken?appId={1}&appSecret={2}

A service token is required for a third party server or service to authenticate with VIVEPORT and access internal resources. If successful, this will return a service token and an expiry date in UNIX time.

Sample response

curl -X GET
"https://www.viveport.com/api/thirdpartygatewayservice/v1/monitor/servicetoken?appId=SampleApp&appSecret=fvma3Hbu75f3OLcxBqvm7n8ASm8S9y"
-H "accept: application/json"
HTTP/1.1 200 OK
{
"serviceToken":
"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJleHAiOjE1MjUzMzQ2NzcsImlhdCI6MTUyNTMzMTA3NywiZHVyYXRpb24iOjM2MDB9.HsdxbtW9-o-d6I_U_gZGS7yE5g4DzD5P39ZnHBq4YU5LCtiz5-UhyNDjEoiqJ-_Z3OJLJYRgD2mX2Gy4YENkdXFA9wV0gi6qC8-5YWHHWFBleQyaDmtH0jUdm6P_pGZgvlMniGsnQaAObzcIh2CRGFZycpqmGzFrSYVaJdqrPtcSm-eJGDTihIgoisZrvZmxYLDQi5cwdoCK-Z3VLyjgsWNVQ-Hg9t6m1kVuKLdjLFkLzTk18NqlpFZ-8yDU2vgrBNFoSzBlDDGozFBho1AKF_Xc8NVqhfNZzKF7mv0NkVzVo8g5FesPQUpNrZY4a2RKdWP0fdIfWL2OfFPx8G-Uqw",
"expire": 1525334677
}

Service token error codes

Type Description
400 Bad request Invalid payload
403 Forbidden Credentials are invalid or the appId does not exist: please contact VIVEPORT admin for help
500 Internal Server Error DB exception