Participants
To list all the participants in live rooms, you need to execute a GET request against the /rooms/live/participants endpoint. The result list is grouped by room. The current session_duration of each live room is specified in seconds.
Since potentially there could be thousands of rooms, pagination is supported with limit, order and after arguments. Read about pagination to learn the details of it. By default maximum 100 live rooms will be returned in the response.
Request (listing all participants in live rooms)
curl --request GET \
--url https://api.digitalsamba.com/api/v1/rooms/live/participants \
--user YOUR_TEAM_ID:YOUR_DEVELOPER_KEY
Response (200 OK)
{
"total_count": 5134,
"data": [
{
"id": "bdaa431a-681a-424b-bbcd-30dedb48e6ba",
"external_id": null,
"start_time": "2023-02-13T16:45:05.000000Z",
"session_duration": 2366,
"live_participants": [
{
"id": "eb70c648-e01f-498b-96c8-c3aa2899b2f9",
"external_id": null,
"name": "John Smith",
"role": "moderator",
"join_time": "2023-02-13T16:45:05.000000Z"
},
.........................
]
},
{
"id": "16e4c86d-3030-411a-bfac-4e5a7c427e0a",
"external_id": null,
"start_time": "2023-02-13T16:45:41.000000Z",
"session_duration": 2330,
"live_participants": [
{
"id": "48a12f4c-2262-4ea3-b294-2d24682cc507",
"external_id": null,
"name": "Earl Grey",
"role": "moderator",
"join_time": "2023-02-13T16:45:41.000000Z"
}
]
}
]
}
Request (get participants for a concrete live room)
curl --request GET \
--url https://api.digitalsamba.com/api/v1/rooms/bdaa431a-681a-424b-bbcd-30dedb48e6ba/live/participants \
--user YOUR_TEAM_ID:YOUR_DEVELOPER_KEY
Response (200 OK)
{
"id": "bdaa431a-681a-424b-bbcd-30dedb48e6ba",
"external_id": null,
"start_time": "2023-02-13T16:45:05.000000Z",
"session_duration": 2366,
"live_participants": [
{
"id": "eb70c648-e01f-498b-96c8-c3aa2899b2f9",
"external_id": null,
"name": "John Smith",
"role": "moderator",
"join_time": "2023-02-13T16:45:05.000000Z"
},
.........................
]
}
Last updated