There are two manifestations of the API available. One is a J2EE version, and one is a Web Services version. Which one you use depends on your specific situation. Both have the same functionality, but certain usage scenarios tend to lend themselves better to using one over the other.