-
Notifications
You must be signed in to change notification settings - Fork 3
Feature list
The service is divided into the following groups of features:
- Rating and Ratings - Rate and review a product
- Likes - Like a product
- Comments - Added comments to a product
- Favorites - Add a product to my favourites
As you rate, like and comment your products it will accumulate statistics for you, e.g. the average rating, number of likes, comments etc. You can request this information and show in your application.
Each method must include a unique product id provided by the application. The application might receive this id from some other service being integrated, e.g. a product catalog. It is up to the application to provide this id and ensure uniqueness and consistency through requests.
The application can perform all functions either anonymoulsy or providing a unique user identifier. If a unique user id is provided it will be possible to ask for ratings and reviews for a specific user, e.g. my review, my likes, my favorites.
The application can optionally supply a position (latitude and longitude) of the product being rated. This will allow the application to perform nearby operations, e.g. get nearby top average ratings.
There are hopefully many different use cases, but we think the below example might be the most common.
Our dear friend Jenny, recently implemented an iOS app that lists restaurants in Phnom Penh. She is using her existing web site, yourPhnomPenh, to provide the list of restaurants to the APP. Obviously she wants the app users to be able to rate, like, comment and add restaurants as their favourites - enter Pocket-Reviews.
List views When showing a list of restaurants the app will request the product information for each of the restaurant (one request only). For each restaurant the app can now show:
- The average and total number of ratings
- Number of likes
- Number of comments
This make a very nice addition to any list of products, might it be restaurants, movies, songs, games, you name it.
Detail views The details view will show the same information but it will also include a few new options that will allow the user to:
- Rate and optionally write a review
- Like the restaurant
- Comment on the joint
There is also a button for showing each of the rating and comments the place have.
**
Many different user cases can be implemented in the application but we think the two most common
Show in list view
Must support returning a list of items with the following data for each item
- Average rating and total number of ratings (not individual ratings)
- Number of reviews (not each review)
- Number of likes Maybe provide the option so application can specify if the backend should return number of reviews and number of likes or not.
Show in details view
Return all information about an items:
- Average rating and number of ratings
- Number of reviews and all reviews
- Number of likes Maybe provide the option so application can specify if the backend should return reviews and likes or not.