Recorder List
API Endpoint: Retrieve Recorders
This endpoint retrieves a list of recorders with pagination and sorting options. It allows users to fetch details about available recorders based on specified parameters.
Request
Method: GET URL: {{url}}/v1/recorder
Query Parameters:
-
page (integer): The page number of the results to retrieve. Default is 0.
-
pageSize (integer): The number of records to return per page. Default is 20.
-
sortBy (string): The field by which to sort the results, followed by the sorting order. For example, createdAt:desc sorts by the creation date in descending order.
Response
The response will contain a JSON object with the following structure:
-
status (string): The status of the request.
-
data (object): Contains the results of the request.
-
totalCount (integer): The total number of recorders available.
-
page (integer): The current page number of the results.
-
recorderList (array): A list of recorder objects, each containing:
-
duration (integer): The duration of the recording.
-
isAutoAnalyze (boolean): Indicates if the recorder is set for automatic analysis.
-
isActive (boolean): Indicates if the recorder is currently active.
-
recordings (array): An array of recordings associated with the recorder.
-
createdAt (string): The timestamp when the recorder was created.
-
updatedAt (string): The timestamp when the recorder was last updated.
-
userId (string): The ID of the user associated with the recorder.
-
recorderId (string): The unique ID of the recorder.
-
token (string): A token associated with the recorder.
-
name (string): The name of the recorder.
-
meta (object): Metadata about the recorder, including:
-
type (object): Specifies the types of media supported (e.g., video and audio).
-
client (object): Information about the client, including name and email.
Example Response
{
"status": "",
"data": {
"totalCount": 0,
"page": "",
"recorderList": [
{
"duration": 0,
"isAutoAnalyze": true,
"isActive": true,
"recordings": [],
"createdAt": "",
"updatedAt": "",
"userId": "",
"recorderId": "",
"token": "",
"name": "",
"meta": {
"type": {
"video": true,
"audio": true
},
"client": {
"name": true,
"email": true
}
}
}
]
}
}
Request
- Base URL: https://api.speakai.co/v1
- URL: https://api.speakai.co/v1/recorder
- Auth: API key in header x-speakai-key and API key in header x-access-token
Query parameters
Response
OK
Changes
No recorded changes to this operation across all 2 revisions of this API.