mirror of
https://github.com/asterisk/asterisk.git
synced 2025-09-18 18:58:22 +00:00
7a8d6bc81b
In order to not have version number overlap between different versions of Asterisk, each new major version of Asterisk will mean we also bump the ARI major version number. This particular change does NOT introduce any known breaking changes to ARI. For discussion relating to this topice, see: http://lists.digium.com/pipermail/asterisk-dev/2016-November/075964.html Change-Id: I712ee0df177a8fe1252da2bc029705268b97b665
152 lines
3.4 KiB
JSON
152 lines
3.4 KiB
JSON
{
|
|
"_copyright": "Copyright (C) 2012 - 2013, Digium, Inc.",
|
|
"_author": "Kevin Harwell <kharwell@digium.com>",
|
|
"_svn_revision": "$Revision$",
|
|
"apiVersion": "2.0.0",
|
|
"swaggerVersion": "1.1",
|
|
"basePath": "http://localhost:8088/ari",
|
|
"resourcePath": "/api-docs/deviceStates.{format}",
|
|
"apis": [
|
|
{
|
|
"path": "/deviceStates",
|
|
"description": "Device states",
|
|
"operations": [
|
|
{
|
|
"httpMethod": "GET",
|
|
"summary": "List all ARI controlled device states.",
|
|
"nickname": "list",
|
|
"responseClass": "List[DeviceState]"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"path": "/deviceStates/{deviceName}",
|
|
"description": "Device state",
|
|
"operations": [
|
|
{
|
|
"httpMethod": "GET",
|
|
"summary": "Retrieve the current state of a device.",
|
|
"nickname": "get",
|
|
"responseClass": "DeviceState",
|
|
"parameters": [
|
|
{
|
|
"name": "deviceName",
|
|
"description": "Name of the device",
|
|
"paramType": "path",
|
|
"required": true,
|
|
"allowMultiple": false,
|
|
"dataType": "string"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"httpMethod": "PUT",
|
|
"summary": "Change the state of a device controlled by ARI. (Note - implicitly creates the device state).",
|
|
"nickname": "update",
|
|
"responseClass": "void",
|
|
"parameters": [
|
|
{
|
|
"name": "deviceName",
|
|
"description": "Name of the device",
|
|
"paramType": "path",
|
|
"required": true,
|
|
"allowMultiple": false,
|
|
"dataType": "string"
|
|
},
|
|
{
|
|
"name": "deviceState",
|
|
"description": "Device state value",
|
|
"paramType": "query",
|
|
"required": true,
|
|
"allowMultiple": false,
|
|
"dataType": "string",
|
|
"allowableValues": {
|
|
"valueType": "LIST",
|
|
"values": [
|
|
"NOT_INUSE",
|
|
"INUSE",
|
|
"BUSY",
|
|
"INVALID",
|
|
"UNAVAILABLE",
|
|
"RINGING",
|
|
"RINGINUSE",
|
|
"ONHOLD"
|
|
]
|
|
}
|
|
|
|
}
|
|
],
|
|
"errorResponses": [
|
|
{
|
|
"code": 404,
|
|
"reason": "Device name is missing"
|
|
},
|
|
{
|
|
"code": 409,
|
|
"reason": "Uncontrolled device specified"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"httpMethod": "DELETE",
|
|
"summary": "Destroy a device-state controlled by ARI.",
|
|
"nickname": "delete",
|
|
"responseClass": "void",
|
|
"parameters": [
|
|
{
|
|
"name": "deviceName",
|
|
"description": "Name of the device",
|
|
"paramType": "path",
|
|
"required": true,
|
|
"allowMultiple": false,
|
|
"dataType": "string"
|
|
}
|
|
],
|
|
"errorResponses": [
|
|
{
|
|
"code": 404,
|
|
"reason": "Device name is missing"
|
|
},
|
|
{
|
|
"code": 409,
|
|
"reason": "Uncontrolled device specified"
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
],
|
|
"models": {
|
|
"DeviceState": {
|
|
"id": "DeviceState",
|
|
"description": "Represents the state of a device.",
|
|
"properties": {
|
|
"name": {
|
|
"type": "string",
|
|
"description": "Name of the device.",
|
|
"required": true
|
|
},
|
|
"state": {
|
|
"type": "string",
|
|
"description": "Device's state",
|
|
"required": true,
|
|
"allowableValues": {
|
|
"valueType": "LIST",
|
|
"values": [
|
|
"UNKNOWN",
|
|
"NOT_INUSE",
|
|
"INUSE",
|
|
"BUSY",
|
|
"INVALID",
|
|
"UNAVAILABLE",
|
|
"RINGING",
|
|
"RINGINUSE",
|
|
"ONHOLD"
|
|
]
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|