I could think of any number of movie quotes that would share my awe about this API. I could think of any number of speeches I could take lines from that would share the cool factor. I however am going to tell you the story of the IBM Connections Cloud People Finder API.
I was first introduced to the People Finder API last week. I was chatting with Miguel Estrada and we heard a customer requirement for a type-ahead that efficiently finds people. Miguel brought up the People Finder API — “A type-ahead search service to find people in the organization, that produces personalized results tailored for who’s searching.” Released in IBM Connections 5.0 and available on IBM Connections Cloud, the People Finder API is super cool, and very powerful for building applications which need a type-ahead feature.
You can add and quickly make the call using the REST Client we mentioned in prior weeks.
public final static String TYPEAHEAD_ALL = "https://connections.example.com/search/basic/people/typeahead";
private static String CONTENT_TYPE_JSON = "application/json";
private static String user = "firstname.lastname@example.org";
private static String password = "NOTIT";
A simple call using the client:
Response response = RestClient.get(TYPEAHEAD_ALL).basicAuth(user,password).parameter("query", "a").asString();
System.out.println("" + response.getData());
Within reason, I can quickly resolve down my search from “a” to “ab”, and I get a JSON array back. Our Search API lead has gone ahead and annotated the data model very nicely; I’ll just highlight some cool elements.
"id":"5025b040-8e85-102b-9993-99c200cfc5b7", // userid
"name": "Gili Smith", // Display name
"confidence":"high", // [high|medium|low]
How cool is that?!