Please Select Your Location

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

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