mirror of
https://github.com/asterisk/asterisk.git
synced 2025-09-21 20:56:39 +00:00
557125664d
Asterisk REST interface.
This adds the /playback/{playbackId}/control resource, which may be
POSTed to to pause, unpause, reverse, forward or restart the media
playback.
Attempts to control a playback that is not currently playing will
either return a 404 Not Found (because the playback object no longer
exists) or a 409 Conflict (because the playback object is still in the
queue to be played).
This patch also adds skipms and offsetms parameters to the
/channels/{channelId}/play resource.
(closes issue ASTERISK-21587)
Review: https://reviewboard.asterisk.org/r/2559
git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@389603 65c4cc65-6c06-0410-ace0-fbb531ad65f3
116 lines
2.6 KiB
JSON
116 lines
2.6 KiB
JSON
{
|
|
"_copyright": "Copyright (C) 2012 - 2013, Digium, Inc.",
|
|
"_author": "David M. Lee, II <dlee@digium.com>",
|
|
"_svn_revision": "$Revision$",
|
|
"apiVersion": "0.0.1",
|
|
"swaggerVersion": "1.1",
|
|
"basePath": "http://localhost:8088/stasis",
|
|
"resourcePath": "/api-docs/playback.{format}",
|
|
"apis": [
|
|
{
|
|
"path": "/playback/{playbackId}",
|
|
"description": "Control object for a playback operation.",
|
|
"operations": [
|
|
{
|
|
"httpMethod": "GET",
|
|
"summary": "Get a playback's details.",
|
|
"nickname": "getPlayback",
|
|
"responseClass": "Playback",
|
|
"parameters": [
|
|
{
|
|
"name": "playbackId",
|
|
"description": "Playback's id",
|
|
"paramType": "path",
|
|
"required": true,
|
|
"allowMultiple": false,
|
|
"dataType": "string"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"httpMethod": "DELETE",
|
|
"summary": "Stop a playback.",
|
|
"nickname": "stopPlayback",
|
|
"responseClass": "Playback",
|
|
"parameters": [
|
|
{
|
|
"name": "playbackId",
|
|
"description": "Playback's id",
|
|
"paramType": "path",
|
|
"required": true,
|
|
"allowMultiple": false,
|
|
"dataType": "string"
|
|
}
|
|
]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"path": "/playback/{playbackId}/control",
|
|
"description": "Control object for a playback operation.",
|
|
"operations": [
|
|
{
|
|
"httpMethod": "POST",
|
|
"summary": "Get a playback's details.",
|
|
"nickname": "controlPlayback",
|
|
"responseClass": "Playback",
|
|
"parameters": [
|
|
{
|
|
"name": "playbackId",
|
|
"description": "Playback's id",
|
|
"paramType": "path",
|
|
"required": true,
|
|
"allowMultiple": false,
|
|
"dataType": "string"
|
|
},
|
|
{
|
|
"name": "operation",
|
|
"description": "Operation to perform on the playback.",
|
|
"paramType": "query",
|
|
"required": true,
|
|
"allowMultiple": false,
|
|
"dataType": "string",
|
|
"allowableValues": {
|
|
"valueType": "LIST",
|
|
"values": [
|
|
"restart",
|
|
"pause",
|
|
"unpause",
|
|
"reverse",
|
|
"forward"
|
|
]
|
|
}
|
|
}
|
|
],
|
|
"errorResponses": [
|
|
{
|
|
"code": 400,
|
|
"reason": "The provided operation parameter was invalid"
|
|
},
|
|
{
|
|
"code": 404,
|
|
"reason": "The playback cannot be found"
|
|
},
|
|
{
|
|
"code": 409,
|
|
"reason": "The operation cannot be performed in the playback's current state"
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
],
|
|
"models": {
|
|
"Playback": {
|
|
"id": "Playback",
|
|
"properties": {
|
|
"id": {
|
|
"required": true,
|
|
"description": "Playback's identifier.",
|
|
"type": "string"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|