AXL API programming is gaining its importance day by day. The Administrative XML Web Service (AXL) is an XML/SOAP based API that enables remote management of Cisco Unified Communications Manager (CUCM) using any programming languages such as Python.
Sending AXL requests to Cisco CUCM with Postman is pretty straight forward process. Postman is a tool for prototyping APIs, Google Chrome app for interacting with HTTP APIs. It presents you with a friendly GUI for constructing requests and reading responses.
Tool mainly for developers or anyone who wants an easy way for testing any web APIs (including Cisco's AXL API).
Tools Required
- Postman
- Cisco Unified Communications Manager
Step 1: Create Standard AXL API User in CUCM
You can go for either End User or Application user. Since the purpose is for some API testing, I go with Application user.
Go to User Management > User Settings > Access Control Group
![1 CUCM Access Control Group.png 1 CUCM Access Control Group.png](https://community.cisco.com/t5/image/serverpage/image-id/66933iC3D53C5C64B7AA7F/image-size/large?v=v2&px=999)
Click Add New and provide a name,![2 Assign Role to Access Control Group.png 2 Assign Role to Access Control Group.png](https://community.cisco.com/t5/image/serverpage/image-id/66934i1851B3F9D1A79AF0/image-size/large?v=v2&px=999)
On the top right corner, Related Links > Assign Role to Access Control Group. Select Standard AXL API Users![3 Standard AXL API Users.png 3 Standard AXL API Users.png](https://community.cisco.com/t5/image/serverpage/image-id/66935i63FBC70D45AC5225/image-size/large?v=v2&px=999)
Go to User Management > Application User and add a new user. Make sure you assign the Access Control Group just created.![4 AXL Application User.png 4 AXL Application User.png](https://community.cisco.com/t5/image/serverpage/image-id/66936i30B92449AE32D0FD/image-size/large?v=v2&px=999)
Now we are ready with API user and basic settings required from CUCM side.
Step 2: Setting up Postman
Download the Postman tool from above link. Provide below URL in the address bar.
https://[CUCM IP OR FQDN]:8443/axl/
On the Authorization tab, select Type as Basic Auth, enter the User name and Password that we created in Step 1.![5 Postman Basic Authentication with CUCM.png 5 Postman Basic Authentication with CUCM.png](https://community.cisco.com/t5/image/serverpage/image-id/66937i5EFCA1E494B76ECB/image-size/large?v=v2&px=999)
Step 3: Send a GET Request to CUCM AXl API
Go to ‘BODY’ tab, select ‘GET’ at the address bar and click send.![6 CUCM Postman GET.png 6 CUCM Postman GET.png](https://community.cisco.com/t5/image/serverpage/image-id/66939iFDC77D0D5D52F03B/image-size/large?v=v2&px=999)
Note: Here you are not sending any data. It is just blank body. Once you scroll down, you will be able to see below,![7 Postman GET request to CUCM TEST.png 7 Postman GET request to CUCM TEST.png](https://community.cisco.com/t5/image/serverpage/image-id/66940i1FF57F6E006438D2/image-size/large?v=v2&px=999)
At this point, everything looks good. We can start sending HTTP POST requests in body.
Step 4: Send HTTP Post to Pull Phone Details
Here is the CUCM AXL API query to pull all the Phone details.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.cisco.com/AXL/API/10.5">
<soapenv:Header/>
<soapenv:Body>
<ns:getPhone>
<name>SEP501CB00C71D5</name>
</ns:getPhone>
</soapenv:Body>
</soapenv:Envelope>
Paste the request in body of Postman and select Post request.![8 CUCM AXL Phone Details query.png 8 CUCM AXL Phone Details query.png](https://community.cisco.com/t5/image/serverpage/image-id/66943i9F475C16409C12AB/image-size/large?v=v2&px=999)
Once you send the request, here is what you get.
![9 Getting CUCM Phone Details via AXL API .png 9 Getting CUCM Phone Details via AXL API .png](https://community.cisco.com/t5/image/serverpage/image-id/66942iFC906D6E72B76125/image-size/large?v=v2&px=999)
For more custom AXL queries, you can refer https://developer.cisco.com/docs/axl/#!what-is-axl/what-is-administrative-xml Let me know your thoughts about this article in below comment box.