Retrieving mobile numbers via Lotus Connections API
I’ve been baffled for several months as to why you couldn’t get at the mobile number via the Lotus Connections ATOM API – only the “work” telephone number.
In the summer I noticed that not all telephone numbers were visible in the XML returned via the ATOM API for Lotus Connections 2.5. Everywhere I checked behaved the same, including the Lotus Greenhouse. I’d studied the documentation, and there didn’t seem to be any way to get any more data out.
I even had a dialogue with IBM, as well as few Lotus people via Twitter, but it just didn’t appear possible. There was definitely a bug with vCards, and there seemed to be one with the API too.
I was on the verge of pushing for an alternative API to be quickly developed (rather than waiting another half a year for a fix-patch) when Jan Fjärnström discovered that there was a mistake in the Lotus Connections documentation.
On the Searching Profiles page, it says:
Specifies whether you want a full profile or partial profile to be returned. Options are lite or full. The default value is full.
In reality the default value is infact lite.
So, if we’d have tested putting:
&format=full at the end of API requests, it would have worked. Amazingly, I’d tested:
&format=lite (the incorrectly stated “non default” value), but as full was default, I hadn’t tested to specifically add &format=full.
A more complete example would be:
Lesson? Never stop being curious! test everything…