Here is an exclusive look at what I’ve found within Maximo’s integration framework. You won’t find this anywhere else on the web as this stuff is not documented by IBM for Maximo. The REST API can be found in Maximo versions 22.214.171.124 and up including Maximo 7.5. If you look in the directories where you build your maximo.ear files (SMP/maximo/applications/maximo/maxrestweb/), you should be able to see a new file called maxrestweb.war. This is where all the magic happens begins.
I’m sure most of you are already aware of the now old fashioned regular Maximo Integration Framework web services where you use plain old SOAP messages to send to Maximo. Well REST web services don’t use SOAP message to pass data. REST stands for Representational State Transfer and it’s a stateless, client-server protocol.
REST is an architecture style for designing networked applications. The idea is that, rather than using complex mechanisms such as CORBA, RPC or SOAP to connect between machines, simple HTTP is used to make calls between machines.
- In many ways, the World Wide Web itself, based on HTTP, can be viewed as a REST-based architecture.
RESTful applications use HTTP requests to post data (create and/or update), read data (e.g., make queries), and delete data. Thus, REST uses HTTP for all four CRUD (Create/Read/Update/Delete) operations.
REST is a lightweight alternative to mechanisms like RPC (Remote Procedure Calls) and Web Services (SOAP, WSDL, et al.). Later, we will see how much more simple REST is.
- Despite being simple, REST is fully-featured; there’s basically nothing you can do in Web Services that can’t be done with a RESTful architecture.
REST is not a “standard”. There will never be a W3C recommendataion for REST, for example. And while there are REST programming frameworks, working with REST is so simple that you can often “roll your own” with standard library features in languages like Perl, Java, or C#. [via Elkstein.org]
You can always learn more about REST and how to use it by searching the web, but this post is about Maximo’s REST API and how to use it. Now on to the good stuff…