mirror of
https://github.com/asterisk/asterisk.git
synced 2025-09-06 12:36:58 +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
135 lines
3.0 KiB
JSON
135 lines
3.0 KiB
JSON
{
|
|
"_copyright": "Copyright (C) 2013, Digium, Inc.",
|
|
"_author": "Jonathan Rose <jrose@digium.com>",
|
|
"_svn_revision": "$Revision$",
|
|
"apiVersion": "2.0.0",
|
|
"swaggerVersion": "1.1",
|
|
"basePath": "http://localhost:8088/ari",
|
|
"resourcePath": "/api-docs/mailboxes.{format}",
|
|
"apis": [
|
|
{
|
|
"path": "/mailboxes",
|
|
"description": "Mailboxes",
|
|
"operations": [
|
|
{
|
|
"httpMethod": "GET",
|
|
"summary": "List all mailboxes.",
|
|
"nickname": "list",
|
|
"responseClass": "List[Mailbox]"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"path": "/mailboxes/{mailboxName}",
|
|
"description": "Mailbox state",
|
|
"operations": [
|
|
{
|
|
"httpMethod": "GET",
|
|
"summary": "Retrieve the current state of a mailbox.",
|
|
"nickname": "get",
|
|
"responseClass": "Mailbox",
|
|
"parameters": [
|
|
{
|
|
"name": "mailboxName",
|
|
"description": "Name of the mailbox",
|
|
"paramType": "path",
|
|
"required": true,
|
|
"allowMultiple": false,
|
|
"dataType": "string"
|
|
}
|
|
],
|
|
"errorResponses": [
|
|
{
|
|
"code": 404,
|
|
"reason": "Mailbox not found"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"httpMethod": "PUT",
|
|
"summary": "Change the state of a mailbox. (Note - implicitly creates the mailbox).",
|
|
"nickname": "update",
|
|
"responseClass": "void",
|
|
"parameters": [
|
|
{
|
|
"name": "mailboxName",
|
|
"description": "Name of the mailbox",
|
|
"paramType": "path",
|
|
"required": true,
|
|
"allowMultiple": false,
|
|
"dataType": "string"
|
|
},
|
|
{
|
|
"name": "oldMessages",
|
|
"description": "Count of old messages in the mailbox",
|
|
"paramType": "query",
|
|
"required": true,
|
|
"allowMultiple": false,
|
|
"dataType": "int"
|
|
},
|
|
{
|
|
"name": "newMessages",
|
|
"description": "Count of new messages in the mailbox",
|
|
"paramType": "query",
|
|
"required": true,
|
|
"allowMultiple": false,
|
|
"dataType": "int"
|
|
}
|
|
],
|
|
"errorResponses": [
|
|
{
|
|
"code": 404,
|
|
"reason": "Mailbox not found"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"httpMethod": "DELETE",
|
|
"summary": "Destroy a mailbox.",
|
|
"nickname": "delete",
|
|
"responseClass": "void",
|
|
"parameters": [
|
|
{
|
|
"name": "mailboxName",
|
|
"description": "Name of the mailbox",
|
|
"paramType": "path",
|
|
"required": true,
|
|
"allowMultiple": false,
|
|
"dataType": "string"
|
|
}
|
|
],
|
|
"errorResponses": [
|
|
{
|
|
"code": 404,
|
|
"reason": "Mailbox not found"
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
],
|
|
"models": {
|
|
"Mailbox": {
|
|
"id": "Mailbox",
|
|
"description": "Represents the state of a mailbox.",
|
|
"properties": {
|
|
"name": {
|
|
"type": "string",
|
|
"description": "Name of the mailbox.",
|
|
"required": true
|
|
},
|
|
"old_messages": {
|
|
"type": "int",
|
|
"description": "Count of old messages in the mailbox.",
|
|
"required": true
|
|
},
|
|
"new_messages": {
|
|
"type": "int",
|
|
"description": "Count of new messages in the mailbox.",
|
|
"required": true
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|