Webex

The following services are supported by the REST connector for Webex.

get

API to send GET command to the device.

Argument	Description	Default
`dn`	Unique distinguished name describes the place in the tree	Mandatory
`headers`	Headers to send with the GET command	{Authorization: Bearer <access token>}
`timeout`	Maximum time it can take to disconnect to the device.	30 seconds
`expected_return_code`	Return code that is expected.	None (Any good result)

# Assuming the device is already connected
url = '/v1/people/me'
output = device.rest.get(url)

post

API to send POST command to the device.

Argument	Description	Default
`dn`	Unique distinguished name describes the place in the tree	Mandatory
`payload`	Payload to send to the device	Mandatory
`headers`	Headers to send with the GET command	{Authorization: Bearer <access token>}
`timeout`	Maximum time it can take to disconnect to the device.	30 seconds
`expected_return_code`	Return code that is expected.	None (Any good result)

# Assuming the device is already connected
payload = """
{
  "toPersonId": "<person_id>",
  "text": "hello"
}
"""

url = 'v1/messages/'
device.rest.post(url, payload)

delete

API to send DELETE command to the device.

Argument	Description	Default
`dn`	Unique distinguished name describes the place in the tree	Mandatory
`headers`	Headers to send with the GET command	{Authorization: Bearer <access token>}
`timeout`	Maximum time it can take to disconnect to the device.	30 seconds
`expected_return_code`	Return code that is expected.	None (Any good result)

# Assuming the device is already connected
url = 'v1/messages/<message_id>'
device.rest.delete(url)

put

API to send PUT command to the device.

Argument	Description	Default
`dn`	Unique distinguished name describes the place in the tree	Mandatory
`payload`	Payload to send to the device	Mandatory
`headers`	Headers to send with the GET command	{Authorization: Bearer <access token>}
`timeout`	Maximum time it can take to disconnect to the device.	30 seconds
`expected_return_code`	Return code that is expected.	None (Any good result)

# Assuming the device is already connected
payload = """{
    "roomId": "<room_id>",
    "text": "hello again!"
}
"""
url = 'v1/messages/<message_id>'
output = device.rest.put(url, payload)

Section author: Takashi Higashimura <tahigash@cisco.com>