• 3 level integration:
  • API calls for getting XML/JSON data back for integrating in catalog - [API]
  • API calls that return dynamic URL for widget to open in light-box over catalog for particular user - [lightbox]
  • Dynamic widgets for particular user to place right in catalog - [widget]
• Standard Connections and Reviews implementation in search results, item details pages and at ANY item information throughout catalog (like checked out items, reading history, etc.)
• Search results enhancement using ChiliFresh data

• If and how do we implement looking at other user profiles in Connections?
• How do we style widgets? Do we agree on dimensions and styles before?
• What do we show to a user if Connections is not accessible (for whatever reason)?
• How do we handle errors/conflicts of single-sign on, e.g., user logs on OPAC user account, but for some reason (incorrect identifier, inexistent user, etc.) does not get logged in Connections?
• How do we ask users to write reviews on the items they check back in? E-mail them?
• How do we handle users that already are ChiliFresh users and will have registered with the particular e-mail addresses?
• How do we identify OPAC requests with user_key parameter? Can we set up specific OPAC IP(s)?

• Register [API/widget/lightbox]
  • Using single sign-on [API]
  • Using username and password [API/widget/lightbox]
  • Using Twitter and Facebook [widget/lightbox]
• Login [API/widget/lightbox]
  • Using single sign-on [API]
  • Using username and password [API/widget/lightbox]
  • Using Twitter and Facebook [widget/lightbox]
• Sign-out [API]
• Get/edit user information [API/widget/lightbox]
  • Gender
  • City (gets from library's settings, but can edit)
  • State (gets from library's settings, but can edit)
  • Country (gets from library's settings, but can edit)
  • Favorite quote
  • Birth date + whether to show it on profile
  • Current read - ISBN/UPC
  • User picture (3 sizes, JPG, GIF or PNG)
  • Facebook integration (user ID for opening user's FB page)
  • Twitter integration (username for opening Twitter profile)
• User's news / updates (API/widget can show new items since last session in each) [API/widget/lightbox]:
  • Reviews
  • Recommendations
  • Friending invitations
  • Comments (like other user posts on wall)
  • Messages (internal messaging)
  • Replies to user's posts in discussion groups
  • Book clubs that are about to start
• User statistics (includes user's data + average for the same number for all of user's friends) [API/widget]:
  • Number of friends
  • Books on bookshelves
  • Reviews posted
  • Number of recommendations made
  • Number of comments on wall
• User histories [API/widget/lightbox]:
  • Who visited user's profile (last 10 people)
  • Which profiles user visited (last 10 people)
  • Which items user last visited (last 10 items)
• Get/set user interests - [API/lightbox]

Creates a new user bookshelf

• URL for XML output: https://secure.chilifresh.com/api/connections/
• URL for JSON output: https://secure.chilifresh.com/api/connections/json/
• Method: POST
• Parameters:

XML output example:

<?xml version="1.0"?>
<response>
 <response_code>2100</response_code>
 <response_description>Bookshelf created successfully</response_description>
 <response_time>Sat, 27 Dec 2014 13:02:20</response_time>
 <user_id>64</user_id>
 <shelf_id>22773</shelf_id>
 <shelf_name>APIshelf</shelf_name>
</response>

Delete an existing bookshelf of user

• URL for XML output: https://secure.chilifresh.com/api/connections/
• URL for JSON output: https://secure.chilifresh.com/api/connections/json/
• Method: POST
• Parameters:

XML output example:

<?xml version="1.0"?>
<response>
 <response_code>123</response_code>
 <response_description>Shelf deleted successfully</response_description>
 <response_time>Sat, 27 Dec 2014 13:51:32</response_time>
</response>

Changes settings of a bookshelf

• URL for XML output: https://secure.chilifresh.com/api/connections/
• URL for JSON output: https://secure.chilifresh.com/api/connections/json/
• Method: POST
• Parameters:

XML output example:

<?xml version="1.0"?>
<response>
 <response_code>2300</response_code>
 <response_description>Settings changed successfully</response_description>
 <response_time>Sat, 27 Dec 2014 15:30:23</response_time>
</response>

• Show user's bookshelf [widget/lightbox] - the widget can be displayed just as on Connections

For all features [API/lightbox]:

• Get bookshelves - there can be several created by user
• Create / delete bookshelves
• Get bookshelf items - get items on particular bookshelf, sort them by title, author
• Add item to bookshelf - add items to particular bookshelf. There is “default bookshelf” setting
• Remove item from bookshelf
• Move item between bookshelves
• Create bookshelf widget - create widget and then retrieve code snippet for posting on blog or Facebook page
• Import items - import items from files from other services like Goodreads, Shelfari, etc.

For all features [API/lightbox]:

• Add item manually - if item does not show up in library's or Connections search results, add item manually by adding ISBN/UPC, title, author and cover
• Set item as current read - user can set current read to display on profile
• Get item information - title, author, ISBN, etc. that we may have
• Get item users (users who have item on their bookshelves)
• Item tagging - get, add tags for particular item, retrieve items by tags. Tags distinguished between user's own tags and other user tags
• Follow/unfollow item - user can follow particular item and see who added item to bookshelf, recommended, reviewed it, etc.
• Get followings - get a list of events on followed items
• Get suggested items - Connections item recommendations based on particular item, other users having it on their bookshelves, other items other users have on their bookshelves, have reviewed, recommended, etc.
• Get items other users visited who checked out particular item - like on Amazon - where you can see what other users bought after buying particular item
• Get related users - get users that are similar to particular user based on their bookshelves, other items other users have on their bookshelves, have reviewed, recommended, etc.
• Get related communities - get communities that are related as above
• Get related book clubs - get book clubs that are related as above
• Get related discussion groups - get discussion groups that are related as above
• Get related chat rooms - get chat rooms that are related as above
• Personal item details - when user started/ended reading, comments, etc. This is private, does not get shared
• Novelist data - gets Novelist content for particular item from API

For all features [API/lightbox]:

• Get user's friends + links to their profiles
• Follow/unfollow other users
• Online/offline parameter of user
• Get “My followings” - which users/friends the user follows
• Get followings - get a list of events on which friend or person user follows has done
• Browse library users
• View other user profile
• Instant messaging with user online [if user online]
• Send internal mail message to user
• Invite a friend who is not yet on Connections
• Shared items - which items on user bookshelves are in common

For all features [API/lightbox]:

• See all recommendations
• Recommend item to user
• Recommend item over e-mail

For all features [API/lightbox]:

• Get communities list + search
• Get book clubs list + search
• Get discussion groups list + search
• Get chat rooms list + search
• Get tags list + search
• Get friends + search
• Get library's users + search

All features in [lightbox]:

• Discussion groups - see all, favorites, join one, create one, etc.
• Chat rooms - see all, favorites, join one, create one, etc.
• Book clubs - see all, favorites, join one, create one, etc.
• Communities - see all, favorites, join one, create one, etc.
• Reference desk chat - talk to reference desk librarian
• Internal messaging - see all sent/received messages, send a message to user