The people API is intended to provide basic person data to gadgets hosted by IBM Connections. The current implementation returns only a minimla subset of the total data model supported by OpenSocial in order to make som of the other Open Social APIs easier to use (namely the ActivityStreams and Microblogging API). It is not intended to be a full implementation and contains no support for the retrieval of relatinoships (such as the people in a given users network). It is expected that this support will be introduced in subsequent versions of IBM Connections.
Summary of limitations
Many fields in the implementation of the Shindig interface are currently ignored, these include the parameters:
An empty person is returned if a request is made without first logging in. Any request for a person or people will return opensocial person objects as specified by the given userId(s) and securityToken which contain:
email (nested in a listfield)
id (relating to waltz)
Convenience methods such as osapi.people.getViewer() will NOT work immediately, it is advised that the osapi.people.get() method is used instead, which defaults to viewer anyway. The following list of parameters is not exhaustive.