{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"6"},"outline":{"value":"false"},"style":{"value":"none"},"type":{"value":"list"},"printable":{"value":"false"}},"macroMetadata":{"macroId":{"value":"6aa3921e-77c2-42e9-b8c0-a42b69b95a48"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"56b0dc4e-ff7e-440f-a4c2-8f848235f28a"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"About","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Extend API Methods","type":"text","marks":[{"type":"link","attrs":{"href":"https://sangomakb.atlassian.net/wiki/spaces/Switchvox/pages/31064573"}}]}]},{"type":"paragraph","content":[{"text":"The Extend API methods let you query information from Switchvox. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Extend is a an XML-based API. You may want to use this ","type":"text"},{"text":"Sample JavaScript Library","type":"text","marks":[{"type":"link","attrs":{"href":"https://sangomakb.atlassian.net/wiki/spaces/Switchvox/pages/31359581"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Connect to the Core Interface","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The Core Interface is an XML web service that uses basic authentication for authorization. You pass in XML requests and the Core Interface passes back an XML response.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Core Interface can be accessed through an easy URL:","type":"text"}]},{"type":"paragraph","content":[{"text":"\thttps://YOUR.PBX.COM/xml","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Test Your Connection","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"To see if you can connect to your Switchvox using the Extend Core API, type the above URL into your browser.","type":"text"}]},{"type":"paragraph","content":[{"text":"The API uses basic authentication, and requires you to be authenticated as an extension-user (or as 'admin' or another administrator). If you have recently logged into Switchvox, then you have already been authenticated and have the proper cookies set. If you are not logged in, then you will see the following prompt. (Read more about ","type":"text"},{"text":"Authentication","type":"text","marks":[{"type":"link","attrs":{"href":"https://en.wikipedia.org/wiki/Basic_access_authentication"}}]},{"text":".)","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"width":468,"id":"a984ed21-69e4-41ec-ad74-3f61b0cc838d","collection":"contentId-31097325","type":"file","height":134}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Log In","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If you type in the username 'admin' and your admin password, then you can use all of the functionality of the API.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you use another administrator account, then the access levels for that account apply when you use the API. For example, if you have read-only access to 'Manage Extensions,' then you can use switchvox.extensions.getInfo, but you cannot use switchvox.extensions.phones.bulk.upload. ","type":"text"}]},{"type":"paragraph","content":[{"text":"If you use an extension and its password, then you can only use the 'users' functionality of the API, and the tasks you do will apply to that extension.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The XML Response","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"NOTE: Extend is a an XML-based API. You may want to use this ","type":"text"},{"text":"Sample JavaScript Library","type":"text","marks":[{"type":"link","attrs":{"href":"https://sangomakb.atlassian.net/wiki/spaces/Switchvox/pages/31359581"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"After you enter a valid username and password, Switchvox returns an XML response to your browser. The response will most likely contain an error that your request XML was empty, but that is fine because we were just testing for connectivity. If you didn't get any response, you might need to check your firewall or the Access Control section on your Switchvox.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Sample XML response:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"width":468,"id":"b3fa8a51-e31e-4d1b-9007-ae5b0d142dd6","collection":"contentId-31097325","type":"file","height":135}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Pick Your Method & Parameters","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Extend API Methods","type":"text","marks":[{"type":"link","attrs":{"href":"https://sangomakb.atlassian.net/wiki/spaces/Switchvox/pages/31064573"}}]}]},{"type":"paragraph","content":[{"text":"First pick which method you want to run. As an example, we have chosen \"switchvox.extension.search\". Every single request is encased in the parent tag \"request\" and the method is an attribute of that tag:","type":"text"}]},{"type":"paragraph","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"This XML is started, but now we need to add parameters. Below are all the possible parameters for the method \"switchvox.extensions.search\".","type":"text"}]},{"type":"table","attrs":{"layout":"align-start","width":1434.0,"localId":"b6fff67b-0a24-4262-9e66-dc70635f730c"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[208.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[150.0]},"content":[{"type":"paragraph","content":[{"text":"Required","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[123.0]},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[831.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[208.0]},"content":[{"type":"paragraph","content":[{"text":"min_extension","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[123.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[831.0]},"content":[{"type":"paragraph","content":[{"text":"Minimum extension number.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[208.0]},"content":[{"type":"paragraph","content":[{"text":"max_extension","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"integer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[123.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[831.0]},"content":[{"type":"paragraph","content":[{"text":"Maximum extension number. If both min/max extension is provided, the max must be greater than the min.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[208.0]},"content":[{"type":"paragraph","content":[{"text":"extension_types","type":"text"},{"type":"hardBreak"},{"text":"extension_type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[123.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[831.0]},"content":[{"type":"paragraph","content":[{"text":"A list of extension types to filter by. See ","type":"text"},{"text":"Extension Types ","type":"text","marks":[{"type":"link","attrs":{"href":"http://developers-dev01-staging.switchvox.com/switchvox/wiki/index.php/Extension_Types"}}]},{"text":"for a list of possible values.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[208.0]},"content":[{"type":"paragraph","content":[{"text":"min_create_date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[123.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[831.0]},"content":[{"type":"paragraph","content":[{"text":"Minimum creation date of extension.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[208.0]},"content":[{"type":"paragraph","content":[{"text":"max_create_date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"date","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[123.0]},"content":[{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[831.0]},"content":[{"type":"paragraph","content":[{"text":"Maximum creation date of extension.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[208.0]},"content":[{"type":"paragraph","content":[{"text":"sort_field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[123.0]},"content":[{"type":"paragraph","content":[{"text":"number","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[831.0]},"content":[{"type":"paragraph","content":[{"text":"The field on which to sort the returned extensions.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[208.0]},"content":[{"type":"paragraph","content":[{"text":"sort_order","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[123.0]},"content":[{"type":"paragraph","content":[{"text":"ASC","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[831.0]},"content":[{"type":"paragraph","content":[{"text":"The order in which to sort returned extensions. Possible values: ASC and DESC.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[208.0]},"content":[{"type":"paragraph","content":[{"text":"items_per_page","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"integer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[123.0]},"content":[{"type":"paragraph","content":[{"text":"50","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[831.0]},"content":[{"type":"paragraph","content":[{"text":"Number of extensions to return per page.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[208.0]},"content":[{"type":"paragraph","content":[{"text":"page_number","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[121.0]},"content":[{"type":"paragraph","content":[{"text":"integer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[123.0]},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[831.0]},"content":[{"type":"paragraph","content":[{"text":"The page number of extensions to return.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"For this example, I want a list of all extensions between extension 100 and 200 and I only want extensions that are either an ivr or a call_queue.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"So first we need to create the parameters parent tag that will enclose our parameter list:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":" ","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":" ","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Next we need to create a tag for each parameter we want to send, and enclose the value of each parameter between starting and closing tags:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":" ","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":" 100","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":" 200","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":" ","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":" ivr","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":" call_queue","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":" ","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":" ","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"You will notice that the extension_types parameter has a sub parameter call extension_type. This denotes that extension_types takes multiple values and extension_types is the parent tag and extension_type is the child tag that will hold the value of each parameter. Mostly, but not always, the parent tag is a plural form of the child tag.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Send Your XML in a Request","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"After you have your XML file, you can connect to the Extend API and send your file.","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported