IdeaJam provides two different ways for developers to interact with the application. Web Services or a JSON API. For more information on how to use these please contact Elguji Software.

IdeaJam Web Services

The WSDL for the IdeaJam web services can be found here: /ICA/eProductivityIJDB.nsf/ideasservice?wsdl

Methods

• addComment(String ideaId, Comment_n6 comment, String securityKey) - returns boolean success
• addIdea(Idea_n6 idea, String securityKey) - returns String ideaId
• findIdeaById(String ideaId, String securityKey) - returns Idea_n6 idea
• getIdeaSpaces(String securityKey) - returns IdeaSpace_n6_Array_Holder ideaspaces
• getRecentComments(String, ideaSpace, String securityKey) - returns Comment_n6_Array_Holder comments
• getRecentIdeas(String ideaSpace, Long count, String securityKey) - returns Idea_n6_Array_Holder ideas
• getRecentIdeasByAuthor(String author, Long count, String securityKey) - returns Idea_n6_Array_Holder ideas
• getRecentIdeasByTag(String tag, String ideaSpace, Long count, String securityKey) - returns Idea_n6_Array_Holder ideas
• getStats(String securityKey) - returns Stats
• getTopInnovators(String securityKey) - returns TopInnovator_n6_Array_Holder innovators
• getTopTags(String securityKey) - returns String_Array_Holder tags
• getVotesForIdea(String ideaId, String securityKey) - returns Vote_n6_Array_Holder votes
• getWhatsHot(String securityKey) - returns Idea_n6_Array_Holder ideas
• searchIdeas(String search, String, securityKey) - returns Idea_n6_Array_Holder ideas

Security Web Service

The WSDL for the IdeaJam security web service which allows remote authentication can be found here: /ICA/eProductivityIJDB.nsf/securityservice?wsdl

Methods

• getSecurityKey(String username, String password) - returns String securityKey

IdeaJam JSON API

Examples / Tests of the JSON API can be found here.

addComment

Accessed via a post request at: /ICA/eProductivityIJDB.nsf/jsonAddComment

Parameters

• securitykey your Security Key (found on your IdeaJam profile)
• ideaid the id of the idea which the comment is related to
• comment the comment itself

Response

A JSON object containing the result of the operation

addIdea

Accessed via a post request at: /ICA/eProductivityIJDB.nsf/jsonAddIdea

Parameters

• securitykey your Security Key (found on your IdeaJam profile)
• idea the title of the idea
• body the description of the idea
• ideaspace the IdeaSpace of the idea (if you are using sub IdeaSpaces, separate with a comma (,)
• linkedideaid the id of linked idea(s), separate with a comma (,)
• tags list of tags for the idea, separate with a comma (,)

Response

A JSON object containing the id of the new idea

findIdeabyId

Accessed via a post request at: /ICA/eProductivityIJDB.nsf/jsonFindIdeaById

Parameters

• securitykey your Security Key (found on your IdeaJam profile)
• ideaid the id of the idea

Response

A JSON object containing the idea which you searched for

getIdeaSpaces

Accessed via a get request at: /ICA/eProductivityIJDB.nsf/jsonGetIdeaSpaces

Parameters

• None

Response

A JSON object containing the IdeaSpaces in the IdeaJam

getRecentComments

Accessed via a get request at: /ICA/eProductivityIJDB.nsf/jsonGetRecentComments

Parameters

• IdeaSpace an optional IdeaSpace to show recent comments from.

Response

A JSON object containing the most recent comments in the IdeaJam

getRecentIdeas

Accessed via a get request at: /ICA/eProductivityIJDB.nsf/jsonGetRecentIdeas

Parameters

• Count the number of ideas to return, defaults to 30 if left blank
• IdeaSpace an optional IdeaSpace to show recent comments from.

Response

A JSON object containing the most recent ideas in the IdeaJam

getRecentIdeasByAuthor

Accessed via a get request at: /ICA/eProductivityIJDB.nsf/jsonGetRecentIdeasByAuthor

Parameters

• Count the number of ideas to return, defaults to 30 if left blank
• Author the name of the person you are getting ideas for

Response

A JSON object containing the most recent ideas in the IdeaJam for that person

getRecentIdeasByTag

Accessed via a get request at: /ICA/eProductivityIJDB.nsf/jsonGetRecentIdeasByTag

Parameters

• Count the number of ideas to return, defaults to 30 if left blank
• Tag the tag you are getting ideas for
• IdeaSpace an optional IdeaSpace to restrict the results to

Response

A JSON object containing the most recent ideas in the IdeaJam for that tag

getStats

Accessed via a get request at: /ICA/eProductivityIJDB.nsf/jsonGetStats

Parameters

• None

Response

A JSON object containing the statistics about the IdeaJam

getTopInnovators

Accessed via a get request at: /ICA/eProductivityIJDB.nsf/jsonGetTopInnovators

Parameters

• None

Response

A JSON object containing the top innovators in the IdeaJam

getTopTags

Accessed via a get request at: /ICA/eProductivityIJDB.nsf/jsonGetTopTags

Parameters

• None

Response

A JSON object containing the top tags in the IdeaJam

getVotesForIdea

Accessed via a get request at: /ICA/eProductivityIJDB.nsf/jsonGetVotesForIdea

Parameters

• ideaid the id of the idea you want to get votes for

Response

A JSON object containing the votes for the idea

getWhatsHot

Accessed via a get request at: /ICA/eProductivityIJDB.nsf/jsonGetWhatsHot

Parameters

• None

Response

A JSON object containing the list of hot ideas

searchIdeas

Accessed via a post request at: /ICA/eProductivityIJDB.nsf/jsonSearchIdeas

Parameters

• securitykey your Security Key (found on your IdeaJam profile)
• search the query you want to search for

Response

A JSON object containing the matching ideas