Using REST API's by Glenn Inn
Sometimes you may have an application that needs to make a Public Switched Telephone Network (PSTN) phone call to quickly bring an individual into a meeting.
This step by step guide will provide you with an example of how to use the onVideo REST API's to create a participant space in an existing meeting, and then ask BlueJeans to place a phone call to an intended participant.
BlueJeans REST API messages must contain certain formatting values in order to be recognized as valid. Please ensure that each REST call has the following fields:
Step 1
Get Access to the Meeting
The first step an application must do is get access to the meeting on behalf-of the intended participant..
For this authentication, you will need from the BlueJeans a meeting access token which becomes your software passkey to make API calls to add a participant, and outdial to them.
BlueJeans uses the industry standard OAuth protocol for authentication.
{ grant_type: "meeting_passcode", meetingNumericId : "12345678", meetingPasscode : "1234" }
{ "access_token": "80073a884e ... e7f8b70571077f@z1", "expires_in": 86400, "scope": { "meeting": { "id": 8675433, "leaderId": 1407819, "meetingNumericId": "4159908751", "meetingUri": "/v1/user/1407819/live_meetings/4159908751", "isModerator": false, "endpointUriSet": [], "meetingId": "8675433" }, "partitionName": "z1", "partition": { "id": 1, "name": "z1" } } }
Step 2
Create a Space at the Table
In this step you must make BlueJeans create a space for the intended party to be able to join this virtual meeting.
Along with this API call, you must pass the access_token obtained from the Authentication step.
{ endpointName : "Glenn on iPhone", endpointType : "PSTN", capabilities : ["AUDIO"] }
{ pairingCode : "7169943", connectionGuid : "connguid:14b66f88-8c90-464e-a658-62977a725fef", seamEndpointGuid : "seamguid:ea863317-b3c1-4808-8ad6-b55268a4886a", endpointName : "Glenn on iPhone" }
Step 3
Get the Invitee ...
In this step you instruct the BlueJeans cloud to outdial to your intended participant.
Along with this API call, you must pass the access_token obtained from the Authentication step.
{ connectionGuid : "connguid:14b66f88-8c90-464e-a658-62977a725fef", pairedParticipantGuid : "seamguid:ea863317-b3c1-4808-8ad6-b55268a4886a", countryCode : 1, phoneNumber : "4159908751" }
{ connectionGuid : "connguid:14b66f88-8c90-464e-a658-62977a725fef", endpointGuid : "seamguid:ea863317-b3c1-4808-8ad6-b55268a4886a" }