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 |