Migrating Video REST API from OpenTok to Unified

Objective

If you are using the REST API, you need to change the authentication method and the base request URL. For an overview of the complete migration process, please refer to this article.

Applies To

• Video API customers planning to migrate from the OpenTok environment to the Unified environment
• Video REST API

Procedure

1. Update the base URL

Update your Video REST API endpoint to the Unified base URL.

• OpenTok: https://api.opentok.com
• Unified: https://video.api.vonage.com

2. Change authentication

The Unified Video REST API also uses JWT authentication in the Unified environment, but the authentication method differs from the OpenTok environment. In the OpenTok environment, JWTs are generated using the Project Key and Project Secret and are sent in the custom request header. In the Unified environment, JWTs are generated using the Application ID and Private Key and are sent as a Bearer token in the Authorization header.

{
  "iss": "your_api_key",
  "ist": "project",
  "iat": 1692268800,
  "exp": 1692269100,
  "jti": "jwt_nonce"
}

{
 "iat": 1692268800,
 "exp": 1692269100,
 "application_id": "your_application_id",
 "jti": "jwt_nonce"
}

Additional Information

• OpenTok to Unified Migration FAQ