Cisco Cisco 3365 Mobility Services Engine Livre blanc

 

 

© 2013 Cisco and/or its affiliates. All rights reserved. This document is Cisco Public Information. 

Page 48 of 55 

Figure 50.    Generic Northbound Notifications 

 

Cisco MSE provides public SOAP APIs for interaction with Cisco MSE collected data. The SOAP API has the 

following characteristics: 

●

 

The API is heavyweight; all data is wrapped in a SOAP envelope. 

●

 

SOAP can be hard to use on mobile devices. There is no native library. 

●

 

The API supports only the XML data format. It can be difficult to parse on the client side directly and the 

syntax for elements is verbose. Parsing is expensive on mobile devices. 

●

 

The data model is bloated. It includes a lot of unnecessary parameters that cannot be removed because 

doing so may break existing applications. 

●

 

The client needs to understand the object and database hierarchy to get the correct response. 

●

 

Data for some devices is split across different APIs. 

●

 

The API is session oriented. API users have to manually embed the session ID in all API requests. 

●

 

API developers must learn an old technology. 

Cisco MSE 7.5 adds support for Representational State Transfer (REST) APIs. REST APIs simplify API use and 

are lightweight for direct use from mobile devices. The advantages of REST APIs include the following: 

●

 

They are based on the stateless REST architecture. 

●

 

The information is delivered over the well-understood HTTP and HTTPS protocols. 

●

 

They have a simplified design and easy-to-understand resource URIs, which usually are self-explanatory. 

●

 

Standardized libraries allow content negotiation capabilities by automatically sending the response in the 

user-requested format. 

●

 

They allow developers to simplify their data models, deprecate older nonscalable APIs, remove hierarchy 

dependency, and add other enhancements.