I've audited all modules that include any header which includes asterisk/optional_api.h. All modules which use OPTIONAL_API now declare those dependencies in AST_MODULE_INFO using requires or optional_modules as appropriate. In addition ARI dependency declarations have been reworked. Instead of declaring additional required modules in res/ari/resource_*.c we now add them to an optional array "requiresModules" in api-docs for each module. This allows the AST_MODULE_INFO dependencies to include those missing modules. Change-Id: Ia0c70571f5566784f63605e78e1ceccb4f79c606
138 lines
3.1 KiB
JSON
138 lines
3.1 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}",
|
|
"requiresModules": [
|
|
"res_stasis_mailbox"
|
|
],
|
|
"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
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|