REST API‎ > ‎TalkSpaces‎ > ‎

TalkSpace Details

This method retrieves detailed information about a TalkSpace, including a list of current conference participants.

Method: GET
URI: /api/rest/conference/{conferenceid}

Path parameter:
  • conferenceid  The ID of the conference to return details on.
Query parameter:
  • appkey  The application key.
Returns:
  • OK(200)  Success.
  • BAD_REQUEST(400)  The application key or conference ID is invalid.
Response format: JSON

Example using curl:

curl "https://api.telesocial.com/api/rest/conference/1bd8ccbd71424585b5e87c4fde77e3d8?appkey=1f1bbca5-b71f-4938-97b6-59fed80623bc"

Response body: 

example - a conference that has terminated
{"ConferenceDetailsResponse":{"message":"","status":200,"conferenceId":"1bd8ccbd71424585b5e87c4fde77e3d8","ended":"2011-09-23T20:47:03.516-07:00","started":"2011-09-23T20:43:26.558-07:00","state":"Closed"}}

example - a conference that is active
{"ConferenceDetailsResponse":{"message":"","status":200,"conferenceId":"1bd8ccbd71424585b5e87c4fde77e3d8","participants":["eta4","etapcs"],"started":"2011-09-27T13:57:20.387-07:00","state":"InProgress"}}



Cool PHP Examples:

    public function conferenceSize($conferenceID)
    {
        $query = new telesocialQuery('conference', $conferenceID . '?appkey=' . self::$config['apiKey']);
        $query->make();
        if ($query->response['status'] == 200)
        {
            return isset($query->response['participants']);
        }
        return false;
    }