/meetings ⇒

GET

This API is used to fetch all sessions or meetings that have ended.

Your application server must provide a /meetings endpoint to Android/Web/IOS clients to fetch the meeting list that has ended.

API signature in your application server.

* ENDPOINT :	'/meetings'
* METHOD   :	GET
* HEADERS  :	Content-type: application/json
* RESPONSE :	{ "error": null, "data" : <Meetings data which have ended> }

To implement the /meetings API under your application server use the following details.

* ADMIN BACKEND BASE URL : https://admin.<example.com>/api
* METHOD                 : GET
* API ENDPOINT           : /meetings
* HEADERS                : Content-type: application/json

code snippet

Sample implementation of /meetings API using nodejs technology.

const axios = require("axios");

const ADMIN_BACKEND_URL = "https://admin.<example.com>/api";
const endpoint = "/meetings";

const response = await axios.get(ADMIN_BACKEND_URL + endpoint, req, {
  headers: { "Content-type": "application/json" },
});

return { error: null, data: response };

Sample response from Admin Control.

{
	"error": null,
	"data": [
		{
			"room_name": "r1",
			"unique_id": "r1_1718871014",
			"created_at": "2024-06-20T08:10:14.000Z",
			"destroyed_at": "2024-06-20T08:10:34.000Z"
		},
		{
			"room_name": "r2",
			"unique_id": "r2_1718871064",
			"created_at": "2024-06-20T08:11:04.000Z",
			"destroyed_at": "2024-06-20T08:11:36.000Z"
		}
	]
}

Response expected by Android/Web/IOS clients from Your Application Server.

{
	"error": null,
	"data": [
		{
			"room_name": "r1",
			"unique_id": "r1_1718871014",
			"created_at": "2024-06-20T08:10:14.000Z",
			"destroyed_at": "2024-06-20T08:10:34.000Z"
		},
		{
			"room_name": "r2",
			"unique_id": "r2_1718871064",
			"created_at": "2024-06-20T08:11:04.000Z",
			"destroyed_at": "2024-06-20T08:11:36.000Z"
		}
	]
}

Error Codes:

401 : Unauthorized (If authentication token is invalid or expired)

{
	"data": null,
	"error": {
        	"code": 401,
        	"message": "Unauthorized"
    		 }
}

404 : Not Found (If invalid url or wrong http method is used)

{
	"error": {
    		"code": 404,
        	 "message": "Not found"
    		 },
	"data": null
}

500 : Internal Server Error (If there is any exception on server side)

{
	"error": {
    		"code": 500,
        	 "message": "Internal server error"
    		 },
	"data": null
}

503 : Service unavailable (If there is no domain configured )

{
	"error": {
    		"code": 503,
        	 "message": "Domain not found."
    		 },
	"data": null
}

If your application server is built on Node.js technology, the ProCONF server SDK's getMeetings() method can be used. To integrate proconf-server-sdk please click here.

Call the getMeetings() server SDK method into your application server.

const getMeetingsData = await serverSDK.getMeetings();