Files
asterisk/rest-api/api-docs/endpoints.json
Matthew Jordan 6107712857 AMI/ARI: Update version numbers
Update the semantic versioning of ARI to 1.3.0 and AMI to 2.3.0 to account for
backwards compatible changes going from 12.2.0 to 12.3.0.
........

Merged revisions 414765 from http://svn.asterisk.org/svn/asterisk/branches/12


git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@414766 65c4cc65-6c06-0410-ace0-fbb531ad65f3
2014-05-28 17:46:37 +00:00

118 lines
2.7 KiB
JSON

{
"_copyright": "Copyright (C) 2012 - 2013, Digium, Inc.",
"_author": "David M. Lee, II <dlee@digium.com>",
"_svn_revision": "$Revision$",
"apiVersion": "1.3.0",
"swaggerVersion": "1.1",
"basePath": "http://localhost:8088/stasis",
"resourcePath": "/api-docs/endpoints.{format}",
"apis": [
{
"path": "/endpoints",
"description": "Asterisk endpoints",
"operations": [
{
"httpMethod": "GET",
"summary": "List all endpoints.",
"nickname": "list",
"responseClass": "List[Endpoint]"
}
]
},
{
"path": "/endpoints/{tech}",
"description": "Asterisk endpoints",
"operations": [
{
"httpMethod": "GET",
"summary": "List available endoints for a given endpoint technology.",
"nickname": "listByTech",
"responseClass": "List[Endpoint]",
"parameters": [
{
"name": "tech",
"description": "Technology of the endpoints (sip,iax2,...)",
"paramType": "path",
"dataType": "string"
}
],
"errorResponses": [
{
"code": 404,
"reason": "Endpoints not found"
}
]
}
]
},
{
"path": "/endpoints/{tech}/{resource}",
"description": "Single endpoint",
"operations": [
{
"httpMethod": "GET",
"summary": "Details for an endpoint.",
"nickname": "get",
"responseClass": "Endpoint",
"parameters": [
{
"name": "tech",
"description": "Technology of the endpoint",
"paramType": "path",
"dataType": "string"
},
{
"name": "resource",
"description": "ID of the endpoint",
"paramType": "path",
"dataType": "string"
}
],
"errorResponses": [
{
"code": 404,
"reason": "Endpoints not found"
}
]
}
]
}
],
"models": {
"Endpoint": {
"id": "Endpoint",
"description": "An external device that may offer/accept calls to/from Asterisk.\n\nUnlike most resources, which have a single unique identifier, an endpoint is uniquely identified by the technology/resource pair.",
"properties": {
"technology": {
"type": "string",
"description": "Technology of the endpoint",
"required": true
},
"resource": {
"type": "string",
"description": "Identifier of the endpoint, specific to the given technology.",
"required": true
},
"state": {
"type": "string",
"description": "Endpoint's state",
"required": false,
"allowableValues": {
"valueType": "LIST",
"values": [
"unknown",
"offline",
"online"
]
}
},
"channel_ids": {
"type": "List[string]",
"description": "Id's of channels associated with this endpoint",
"required": true
}
}
}
}
}