Данные из API передаются в формате JSON.
Параметры для подключения:
- VERSION — 1.0
- KEY — Вы можете его посмотреть, авторизовавшись в личном кабинете на странице https://www.commentbook.ru/admin/key
- URL — http://api.commentbook.ru/{VERSION}/?key={KEY}
Внимание! Ключ(параметр key) необходимо передавать в каждом запросе!
Параметры запроса на получение отзывов:
- ACTION — loadComments
- PRODUCT_ID — ID товара в Вашем магазине
- PRODUCT_TITLE — Наименование товара в Вашем магазине
- SORT — Cортировка, может принимать занчения:
-
- date
— по дате
-
- rating
— по рейтингу(звездочки)
-
- rank
— по полездности отзыва
-
- SORT_TYPE — Тип сортировки
-
- asc
— по возрастанию
-
- desc
— по убыванию
-
- LIMIT — Количество отображаемых отзывов, по умолчанию «10»
- PAGE — Номер страницы, по умолчанию «1»
- URL — http://www.commentbook.ru/api/{VERSION}/?key={KEY}&action={ACTION}&product_id={PRODUCT_ID}&product_title={PRODUCT_TITLE}&sort={SORT}&sort_type={SORT_TYPE}&limit={LIMIT}&page={PAGE}
Пример запроса:
http://www.commentbook.ru/api/1.0/?key={KEY}&action=loadComments&product_id=111111&product_title=Apple Iphone 5S&sort=rating&sort_type=desc&limit=10&page=1
Параметры ответа:
- STATUS — true|false. В случае ошибки будет полчен ответ false
- TOTAL_COUNT — Всего отзывов по этому товару
- COMMENTS — Массив отзывов
- id — идентификатор отзыва
- text — текст отзыва
- plus — плюсы товара
- minus — минусы товара
- rating — рейтинг(значение от 1 до 5)
- date — да ( 1.01.2014 )
- display_date — дата ( 1 января 2014 )
- link — ссылка на раздел отзывов о товаре на Яндекс.Маркете
Пример ответа:
{ status: true, total_count: 3, count: 2, comments: [ { id: "3", text: "Текст комментария к товару", plus: "Плюсы товара", minus: "Минусы товара", rating: "1", date: "23.06.2014", display_date: "23 июня 2014", link: "http://market.yandex.ru/product/10495486/reviews" }, { id: "4", text: "Текст комментария к товару", plus: "Плюсы товара", minus: "Минусы товара", raiting: "5", date: "30.06.2014", display_date: "30 июня 2014", link: "http://market.yandex.ru/product/10495486/reviews" } ] }